Upgrading

Fluxlix releases are published as updated Docker images. Upgrading pulls the new images and restarts the services with any required database migrations applied automatically on startup.

Before upgrading

Read the release notes for the version you are upgrading to. Breaking changes, migration notes, and new required environment variables are listed there.
Back up your PostgreSQL database before proceeding.
Note your current version from Admin > System so you can verify the upgrade succeeded.

Upgrade steps

Navigate to your install directory:
```
cd /opt/fluxlix
```
Pull the latest images:
```
docker compose pull
```
Restart the services. Database migrations run automatically on startup:
```
docker compose up -d
```
Verify the upgrade by checking Admin > System. The version shown should match the release you pulled.

If something goes wrong

If a service fails to start after an upgrade, check the container logs:

docker compose logs --tail=100 <service-name>

To roll back, update the image tags in your docker-compose.yml to the previous version and run docker compose up -d again. Restore your database backup if the failed migration altered any data.

Keeping up to date

Subscribe to the Fluxlix release feed or watch the GitHub repository to be notified of new releases. Security releases are marked clearly in the release notes and should be applied promptly.

Next steps

Configuration — Review environment variables if new ones are required by the new version
System Requirements — Verify requirements have not changed for the new version