Alembic Workflow

Lariba Cloud uses Alembic to manage PostgreSQL schema migrations.

Run Alembic from the backend environment where the project dependencies are installed.

Inspect migration heads

alembic heads

This reads the migration graph and does not apply migrations.

alembic current

This connects to the configured database and reports its applied revision.

When the configured database is the intended local development database:

alembic upgrade head

This changes the database schema. Verify the target database before running it.

Do not run upgrade, downgrade, or stamp operations against an environment unless you have confirmed that environment is the intended target.

Do not use a stamp operation to hide an unexplained migration mismatch.