Update

Use this page when SafariDesk is already running and you want to move to a newer version.

Before you update

Back up your PostgreSQL data (dump or snapshot)
Back up uploaded files if they are stored outside Docker volumes
Review the release notes if your deployment is several versions behind

Recommended quick backup commands (example using Docker Volume snapshot): This command is the same in Linux/macOS and Windows PowerShell.

# export Postgres
docker compose exec db pg_dump -U postgres -Fc safaridesk > safaridesk.dump

Update steps

Linux/macOS (bash):

cd SafariDesk_OS/Core
git pull
docker compose up -d --build
# Run migrations and collect static files
docker compose exec api python manage.py migrate
docker compose exec api python manage.py collectstatic --noinput

Windows (PowerShell):

Set-Location SafariDesk_OS/Core
git pull
docker compose up -d --build
# Run migrations and collect static files
docker compose exec api python manage.py migrate
docker compose exec api python manage.py collectstatic --noinput

Verify the update

These commands are the same in Linux/macOS and Windows PowerShell.

docker compose ps
docker compose logs -f api

Make sure the containers are healthy and the app loads in your browser.

If something looks wrong

Check the API logs first
Confirm your .env file still has the required values
Restart the stack with docker compose restart

If the update fails, open Troubleshooting.

Get started

Operations

Self-hosting

Update

Update

Before you update

Update steps

Verify the update

If something looks wrong

​Update

​Before you update

​Update steps

​Verify the update

​If something looks wrong

Update

Before you update

Update steps

Verify the update

If something looks wrong