Display current schema and migration status information for your Akron project.
Display comprehensive information about your schema configuration, database state, and migration status.
When schema and database are synchronized:
📊 Akron Status ================================================== Schema file: akron.json Database: sqlite URL: sqlite:///app.db Tables: 3 ✅ Schema is up to date Applied migrations: 2 Pending migrations: 0
When akron.json has been modified but migrations haven't been generated:
📊 Akron Status ================================================== Schema file: akron.json Database: postgresql URL: postgres://user:***@localhost:5432/myapp Tables: 5 ⚠️ Schema has uncommitted changes Run 'akron db makemigrations' to generate migration Applied migrations: 3 Pending migrations: 0
When migrations have been generated but not applied:
📊 Akron Status ================================================== Schema file: akron.json Database: mysql URL: mysql://user:***@localhost:3306/ecommerce Tables: 8 ✅ Schema is up to date Applied migrations: 5 Pending migrations: 2 📋 Pending migrations: • add_user_preferences.json • create_audit_log.json
When there are configuration or connection issues:
❌ No akron.json found. Run 'akron db init' first.
Or when database connection fails:
📊 Akron Status ================================================== Schema file: akron.json Database: postgresql URL: postgres://user:***@localhost:5432/myapp Tables: 3 ❌ Error checking migration status: connection to server at "localhost" (127.0.0.1), port 5432 failed
Schema is up to date
No uncommitted changes detected
Schema has uncommitted changes
Run makemigrations to generate migration
Pending migrations
Shows list of unapplied migration files
Error states
Configuration or connection issues
| Field | Description | Example |
|---|---|---|
| Schema file | Path to akron.json configuration | akron.json |
| Database | Database provider type | sqlite, mysql, postgresql, mongodb |
| URL | Connection string (credentials masked) | mysql://user:***@localhost:3306/db |
| Tables | Number of tables in schema | 5 |
Number of migrations successfully applied to the database, tracked in the _akron_migrations table.
Migration files in .akron/ directory that haven't been applied yet.
The status command automatically masks sensitive information in database URLs to prevent credential exposure in logs or console output.
mysql://admin:secret123@db.example.com:3306/prod
mysql://admin:***@db.example.com:3306/prod
Status shows "uncommitted changes" → Run akron db makemigrations
Status shows pending migrations → Run akron db migrate
Error messages help identify database connectivity problems
Use these commands based on the status output: