Database & Alembic Operations

When to use

• Running or debugging Alembic migrations
• Inspecting entities, entity_relations, import_jobs state
• Updating schema or indexes
• Investigating migration/startup failures

Migrations

Canonical command (repo root):

• alembic -c alembic.ini upgrade head

Important:

• Migrations are also applied automatically when backend starts (lifespan hook). If backend appears “stuck”, it may be running migrations.
• NEVER CANCEL a migration command once started.

Collapsed migration history