Upgrading

Tracearr uses the latest Docker image tag by default, so upgrading is straightforward — pull the new image and recreate the container.

TimescaleDB and Redis are persisted in a volume, so your database and configuration will be preserved during the upgrade process.

Docker Compose

This guide assumes you followed the Quick Start instructions to set up Tracearr with Docker Compose.

From the directory containing your docker-compose.pg18.yml file, run:

docker compose -f docker-compose.pg18.yml pull tracearr
docker compose -f docker-compose.pg18.yml up -d

This will:

1. Download the latest Tracearr image
2. Recreate the container with the new image
3. Preserve your database and configuration

Docker UI

If you deployed Tracearr through a Docker UI like Portainer, Dockge, or TrueNAS’s built-in Custom App feature, look for an option to re-pull images or redeploy your stack. The exact label varies by tool — see the Docker UI updating guide for details.

Supervised

From the directory containing your docker-compose.supervised-example.yml file, run:

docker compose -f docker-compose.supervised-example.yml pull tracearr
docker compose -f docker-compose.supervised-example.yml up -d

Railway

Railway supports both automatic and manual updates. See the Railway updating guide for how to configure auto-updates or manually trigger an upgrade from the dashboard.

Proxmox VE

If you installed Tracearr using the Proxmox VE community helper script , you can update by logging into the Tracearr LXC container console and running:

update

This command is created automatically during installation. It pulls the latest version of the update script from the community-scripts repository, checks for a newer release, and applies the update.

You can also update all community-script containers at once from the Proxmox host shell using the update-apps  tool.

Unraid

In the Unraid web UI, go to the Docker tab, find Tracearr, and click Check for Updates or Update. Unraid will pull the latest image and recreate the container.

Cleaning Up Old Images

After upgrading, you can remove unused images to free up disk space:

docker image prune