Skip to content

Latest commit

 

History

History
127 lines (87 loc) · 2.9 KB

README.md

File metadata and controls

127 lines (87 loc) · 2.9 KB
Raw

dokku-sentry

Deploy Sentry 8.x on dokku with official postgres and redis plugins.

This setup uses uWSGI as master process for all the child processes needed to properly run Sentry:

; uwsgi.ini
[uwsgi]
master = true
attach-daemon = sentry start
attach-daemon = sentry celery worker
attach-daemon = sentry celery beat

; Run nightly cron
cron = 0 3 -1 -1 -1 sentry cleanup --days=90

HOWTO?

Install dokku plugins

Go to your dokku server and install following plugins:

  1. Install official postgresql plugin
sudo dokku plugin:install https://github.com/dokku/dokku-postgres.git postgres
  1. Install official redis plugin
sudo dokku plugin:install https://github.com/dokku/dokku-redis.git redis

Prepare dokku

  1. Create dokku app
ssh dokku@yourserver apps:create sentry
  1. Create postgresql db and link it to the app
ssh dokku@yourserver postgres:create sentry
ssh dokku@yourserver postgres:link sentry sentry
  1. Create redis instance and link it to the app
ssh dokku@yourserver redis:create sentry
ssh dokku@yourserver redis:link sentry sentry
  1. Add SENTRY_CONF to env vars
ssh dokku@yourserver config:set sentry SENTRY_CONF=./

Clone and deploy

  1. Clone this repository locally
git clone https://github.com/darklow/dokku-sentry.git
cd dokku-sentry
  1. Add remote dokku
git remote add dokku dokku@yourserver:sentry
  1. Deploy app
git push dokku

Setup sentry

After you have sucessfully deployed app to dokku, run following commands to finish installing sentry:

  1. Create database schema.

After migrations you will be prompted to create initial user.

ssh -t dokku@yourserver run sentry "sentry upgrade"
  1. Create user (Optional). Use this step if you skipped it in the previous command.
ssh -t dokku@yourserver run sentry "sentry createuser"

VOILÀ! Open your dokku app url, login and enjoy Sentry!

Customize sentry config

You can customise sentry.conf.py to fit your needs. However you can also override any config variable using dokku env vars. Use SC_ prefix (as of Sentry Config) to override specific sentry config variables. For example:

ssh dokku@yourserver config:set sentry SC_EMAIL_HOST=mail.yourserver.com SC_EMAIL_HOST_USER=sentry@yourserver.com SC_EMAIL_HOST_PASSWORD=XYZ123 SC_SERVER_EMAIL=sentry@yourserver.com SC_EMAIL_USE_TLS=True

Notes

To run sentry help and other commands:

ssh dokku@yourserver run sentry "sentry help"

To enable console prompt use -t

ssh -t dokku@yourserver run sentry "sentry"

If something goes wrong you can use dokku logs to debug:

ssh dokku@yourserver logs sentry -t