Upgrading

Database Migrations

Kaiten uses automatic database migrations via Go's embed package. Migrations run automatically when the API starts, or can be run manually.

Automatic (Default)

Migrations run on API startup. No action needed.

Manual

go run api/cmd/seeder/main.go --run-migrations

This requires KAITEN_DATABASE_CONNECTION_STRING to be set.

Upgrade Procedure

1. Pull the latest code or image
2. Backup your database (if production)
3. Restart the API — migrations run automatically
4. Verify health: curl http://localhost:6000/api/healthz

Breaking Changes

When upgrading between major versions, check the CHANGELOG for:

• Schema changes that require data migration
• API endpoint changes
• Environment variable changes
• Docker Compose configuration changes

Rollback

If needed, roll back by:

1. Restoring the database backup
2. Running the previous API version