> ## Documentation Index
> Fetch the complete documentation index at: https://docs.safaridesk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Update

> Update an existing SafariDesk installation

# 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.

```bash theme={null}
# export Postgres
docker compose exec db pg_dump -U postgres -Fc safaridesk > safaridesk.dump
```

## Update steps

Linux/macOS (bash):

```bash theme={null}
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):

```powershell theme={null}
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.

```bash theme={null}
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](./troubleshooting).