Uninstalling

There is no uninstall script. Removal is a Compose command plus some manual cleanup.

Stop, keeping everything

docker compose -f deploy/docker-compose.yml down

Containers stop, volumes are untouched. Bring it back with the same deploy command and everything is as you left it.

This is what you want for maintenance.

Stop and destroy the state

docker compose -f deploy/docker-compose.yml down -v

No confirmation, no undo

There is no prompt. This is a plain Docker volume removal.

Destroyed:

• The database. Every user, app, host, session and entitlement. Gone.
• The agent’s enrollment secret. The agent will re-enroll using the token.
• The TLS certificate. A new one is generated on next boot, with a new fingerprint, so every client re-trusts.
• The artwork cache. Re-fetched.

Not destroyed:

• User home directories, if you configured a host path. They are a bind mount, not a Compose volume, so down -v never touches them. This is deliberate, and it is the reason a host path is the better storage choice.
• Container images.
• deploy/.env, secrets and all.

Full removal

1. Drain and stop additional agents using the agent-only packaging you installed on those machines. The shipped base Compose file is a complete stack, not a safe generic command for a second host.

2. Take a final backup if there is any chance you want the data. See Backup and restore.

3. Bring the stack down with volumes.

   docker compose -f deploy/docker-compose.yml down -v

4. Remove the home directories. Resolve the effective root for every host under Admin, Fleet, Hosts and verify each exact path before removal. These are everyone’s save games; there is no universal path once per-host roots are in use.

   sudo rm -rf -- <verified-managed-home-root>

5. Remove the images.

   docker image ls --filter reference='ghcr.io/accreleus/quasar/*'
   docker image rm <verified-image-id-or-digest>

   App images pulled or built by Quasar are also on the host. List them before removing, and be careful with a blanket prune if you have other things on this machine.

6. Remove the environment file.

   shred -u deploy/.env

7. Remove the checkout. First leave it, print its absolute path, and verify that no backups or unrelated files were placed inside it. Delete that exact directory using your normal file-management tool.

Host changes to undo

Quasar asks you to make three changes outside Docker. None are removed by any of the above.

The socket buffer sysctl:

sudo rm /etc/sysctl.d/99-quasar.conf

The uinput module load, if you added it and nothing else needs it:

sudo rm /etc/modules-load.d/uinput.conf

Any TLS certificate you added to your machines’ trust stores.

Removing one host from a fleet

Do not tear down the whole deployment for this.

1. Drain the host in Admin, Fleet, Hosts so it stops taking new sessions.
2. Wait for its sessions to finish.
3. Stop the agent on that machine.
4. Forget the host in Admin, Fleet, Hosts.

Its home directories stay where they are. Move or delete them deliberately.