How to update your self-hosted Sentry installation

If you followed my Sentry installation guide, you probably wonder to get it updated to the latest version. Well, I am wondering the same once a month so here we go.

Step 1. Navigate to your sentry installation directory

If you followed my tutorial it may be in the root of your user directory.

cd ~/sentry

Step 2. Stop your docker containers

Make sure to update your sentry installation at a time where traffic is minimal.

docker compose down

Step 3. Make a note of the changes you did, you will need to update the .env again.

You should mostly have changes related to the port and the sentry version.

git diff -- .env

Step 4. Revert the changes you performed (to be able to checkout later)

Make sure you have the diff from above stored before this.

git checkout -- .env

Step 5. Switch to the latest available tag

Before checking out to the new branch, you need to run a fetch which will show you the tags that have been tagged since the last time you fetched. Using the output of the fetch you can proceed to checkout to the version you want.

# git fetch
remote: Enumerating objects: 36, done.
remote: Counting objects: 100% (36/36), done.
remote: Compressing objects: 100% (20/20), done.
remote: Total 36 (delta 18), reused 29 (delta 15), pack-reused 0
Unpacking objects: 100% (36/36), 24.77 KiB | 3.10 MiB/s, done.
From https://github.com/getsentry/self-hosted
   5e1e74b..4045ad0  master     -> origin/master
 * [new tag]         23.7.0     -> 23.7.0
 * [new tag]         23.7.1     -> 23.7.1

Checkout to the new tag.

git checkout tags/23.7.1

Step 6. Run the installation script again

This will take a moment.

bash ./install.sh

Step 7. Restart your containers

You made it. Fire your docker.

docker compose up -d

You are all done, enjoy the latest available features!