Upgrades

Upgrading Frona AI involves pulling the latest code and rebuilding the containers.

Upgrade procedure

1. Back up your data

Always back up before upgrading. See Backups.

docker compose stop frona
tar czf frona-backup-pre-upgrade.tar.gz data/ .env

2. Pull the latest code

git pull origin main

3. Check for configuration changes

Review the changelog or diff for any new environment variables or changed defaults. Update your .env file if needed.

4. Rebuild and restart

docker compose build
docker compose up -d

5. Verify

Check that all services are running:

docker compose ps

Open the web interface and verify everything works as expected.

Rolling back

If something goes wrong:

1. Stop the services: docker compose down
2. Check out the previous version: git checkout <previous-commit>
3. Restore your data backup if needed
4. Rebuild and start: docker compose build && docker compose up -d

Database migrations

SurrealDB handles schema changes automatically in most cases. If a version requires a specific migration, it will be documented in the release notes.

Version pinning

If you want to pin to a specific version instead of tracking main, use git tags:

git checkout v1.2.3
docker compose build
docker compose up -d