How to install Sentry on a Cloud VPS

Sentry is the application monitoring platform developers rely on for error tracking, performance tracing and release health, self-hosted.

Self-hosting your development tools keeps code and project data inside your infrastructure, and the cost does not grow with the number of users.

One-click install on cloudlinux.ro

The fastest way: Sentry installs automatically at the first boot of a new server.

1. Create a Cloud VPS from the control panel.
2. In the configuration step, pick Sentry from the app catalog.
3. Start the server. The install runs in the background for a few minutes and its status shows on the server page.
4. Access details and generated passwords are saved on the server in /root/app-credentials.txt. The app will be available on port 9000.

Manual install on any Ubuntu server

If you prefer doing it yourself, below is the exact script our automatic install runs. Execute it as root on a fresh Ubuntu server (24.04 recommended). It stops at the first error, and when it finishes you will find the access details in /root/app-credentials.txt.

export DEBIAN_FRONTEND=noninteractive
curl -fsSL https://get.docker.com | sh
apt-get install -y git
# Sentry expects generous swap on top of RAM.
if [ ! -f /swapfile ]; then
  fallocate -l 8G /swapfile && chmod 600 /swapfile && mkswap /swapfile && swapon /swapfile
  echo '/swapfile none swap sw 0 0' >> /etc/fstab
fi
ADMIN_PASS=$(openssl rand -base64 24 | tr -dc 'A-Za-z0-9' | cut -c1-16)
VERSION=$(curl -Ls -o /dev/null -w %{url_effective} https://github.com/getsentry/self-hosted/releases/latest)
VERSION=${VERSION##*/}
git clone https://github.com/getsentry/self-hosted.git /opt/sentry
cd /opt/sentry
git checkout "$VERSION"
IP=$(hostname -I | awk '{print $1}')
./install.sh --skip-user-creation --no-report-self-hosted-issues
if grep -q '^system.url-prefix:' sentry/config.yml; then
  sed -i "s|^system.url-prefix:.*|system.url-prefix: http://${IP}:9000|" sentry/config.yml
else
  printf 'system.url-prefix: http://%s:9000\n' "$IP" >> sentry/config.yml
fi
docker compose up --wait
docker compose run --rm web createuser --email [email protected] --password "$ADMIN_PASS" --superuser --no-input
printf 'Sentry: http://%s:9000\nUtilizator: [email protected]\nParola: %s\n' "$IP" "$ADMIN_PASS" > /root/app-credentials.txt

You can also save this script as a recipe in your account and reuse it on any new server.