Repository navigation
v1.0.0
⚠️ Breaking change: database schema baseline
v1.0.0 consolidates the database schema and removes the automatic migration paths for older development/pre-1.0 schemas. This applies to both SQLite and PostgreSQL. Do not assume an existing pre-1.0 database can be upgraded directly.
- Empty databases are initialized with the release baseline.
- Existing databases must already contain the required baseline tables and columns and have a single supported schema marker. Marker
2is accepted only after baseline validation and relabeled to1; this is metadata adoption, not an upgrade of an older schema. - Nonempty unversioned databases, unsupported schema histories, and databases missing required baseline tables or columns are rejected at startup rather than automatically repaired or migrated.
Required upgrade path
Upgrade existing installations through v0.13.0 before installing v1.0.0.
- If running a version older than v0.13.0, upgrade to v0.13.0 first.
- Start the v0.13.0 panel against your existing database and allow its schema migrations to complete successfully. Merely downloading the image or replacing the binary is not enough.
- After v0.13.0 starts successfully, stop it and upgrade to v1.0.0.
Do not skip directly from an older release to v1.0.0. v0.13.0 supplies the migration path; v1.0.0 validates and adopts the resulting baseline. Restoring an older database backup does not make its schema compatible with v1.0.0, and manually changing the schema marker does not migrate it.