Getting updates

Source code

Make sure you are in the Umami project directory before running these commands.

Pull the latest changes from the Git repository:

git pull

Install any new or updated dependencies:

pnpm install

Rebuild the project:

pnpm build

Finally, restart the application:

pnpm start

If you are using a process manager like PM2, restart the process instead:

pm2 restart umami

Docker

Pull the latest image:

docker pull docker.umami.is/umami-software/umami:latest

Then restart your container to use the new image. If using Docker Compose:

docker compose down
docker compose up -d

Refresh database statistics after upgrading

Major upgrades (such as moving to v3) run schema migrations that can leave PostgreSQL's query planner with stale statistics, making dashboard queries slower than expected on large instances. Run ANALYZE to refresh them:

ANALYZE;

This is safe to run on a live database and completes quickly. Afterward, dashboard queries should return to their expected speed.