Appearance

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

Upgrade procedure ​

1. Back up your data ​

Always back up before upgrading. See Backups.

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

2. Pull the latest code ​

bash
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 ​

bash
docker compose build
docker compose up -d

5. Verify ​

Check that all services are running:

bash
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:

bash
git checkout v1.2.3
docker compose build
docker compose up -d
Frona AI