Updating

Quasar checks GitHub for a new release every 30 minutes. When one is available, a button appears in the top bar.

To update:

1. Open System → Software update.
2. Click the update button and confirm.

Only the dashboard container is replaced. It is unavailable for a few seconds; your applications keep running.

You can also press Check for updates to check right away.

The dashboard’s mounts and permissions, the socket proxy and Traefik come from /opt/quasar/docker-compose.yml, which the updater doesn’t touch. When a release needs a newer version of that file, System says so at the top of the page and lists what is missing. Until then, the features that depend on it don’t work — deleting an unused certificate, for example.

To update it, run on the server:

sudo sh -c 'cd /opt/quasar && git pull --ff-only && docker compose up -d'

Traefik, the socket proxy and the dashboard are recreated: sites are unreachable for a few seconds. Applications’ containers are not touched.

If git refuses because you edited docker-compose.yml on the server:

1. sudo git -C /opt/quasar diff shows what you changed.
2. Note what you still need, then sudo git -C /opt/quasar checkout -- docker-compose.yml.
3. Run the command again, and apply your changes back.

Traefik reads the Let’s Encrypt email from ACME_EMAIL in /opt/quasar/.env each time it starts. Servers installed before v0.4.9 had it written into traefik/traefik.yml instead, which stops git pull the day that file changes. System tells those servers to restore it:

sudo git -C /opt/quasar checkout -- traefik/traefik.yml

Nothing restarts, and Traefik keeps the same email.

System → Environment shows the Traefik version in use. When the current Quasar release was tested with a newer one, an update button appears.

• Quasar only offers the version it was tested with, never the latest one on Docker Hub.
• During the update, every site is unavailable for a few seconds, the dashboard included.
• If the new version does not start, Quasar puts the previous one back automatically.

The chosen version is written to /opt/quasar/docker-compose.override.yml. Delete that file to go back to the version pinned in docker-compose.yml.