Upgrading

Back up first. Database changes run automatically when the new version starts, and your configuration and data are left alone.

Linux installer (systemd)

Download and read the installer again, then run it. It checks the checksum, replaces the program and restarts the service if it was running.

curl -fsSLO https://github.com/Crow-Tech-Pte-Ltd/frame/releases/latest/download/install.shless install.shsudo sh install.sh                     # or: sudo sh install.sh --version v1.2.3

Docker Compose

cd frame && git pull                      # updates the compose filescd deploy && docker compose pull && docker compose up -d

With the Caddy setup, use docker compose -f docker-compose.caddy.yml pull and … up -d. If you build the image yourself, run docker compose up -d --build after git pull instead.

The :0 image tag follows 0.x releases. To upgrade only by hand, pin an exact version in the compose file, such as ghcr.io/crow-tech-pte-ltd/frame-server:0.1.0.

Hear about new releases

On the GitHub repository, use Watch → Custom → Releases. Each release lists its changes; upgrade when one is announced, especially for security fixes. sudo frame-admin version (or docker compose exec frame frame-server version) shows what you're running, and so does the admin panel's Overview.