{"id":13409081,"url":"https://github.com/mimischi/dokku-sentry","last_synced_at":"2025-03-23T04:31:47.603Z","repository":{"id":88535478,"uuid":"103023407","full_name":"mimischi/dokku-sentry","owner":"mimischi","description":"Deploy your own instance of Sentry onto Dokku!","archived":false,"fork":false,"pushed_at":"2019-06-12T06:52:57.000Z","size":113,"stargazers_count":66,"open_issues_count":1,"forks_count":14,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-12-06T22:05:34.965Z","etag":null,"topics":["dokku","sentry"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mimischi.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-09-10T11:14:43.000Z","updated_at":"2023-12-14T14:42:51.000Z","dependencies_parsed_at":"2023-03-12T11:30:53.494Z","dependency_job_id":null,"html_url":"https://github.com/mimischi/dokku-sentry","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mimischi%2Fdokku-sentry","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mimischi%2Fdokku-sentry/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mimischi%2Fdokku-sentry/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mimischi%2Fdokku-sentry/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mimischi","download_url":"https://codeload.github.com/mimischi/dokku-sentry/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245056889,"owners_count":20553855,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dokku","sentry"],"created_at":"2024-07-30T20:00:57.868Z","updated_at":"2025-03-23T04:31:47.582Z","avatar_url":"https://github.com/mimischi.png","language":"Python","funding_links":[],"categories":["Monitoring"],"sub_categories":[],"readme":"![Project logo](.github/header.png)\n\n![Sentry version](https://img.shields.io/badge/Sentry-9.1-blue.svg) ![Dokku version](https://img.shields.io/badge/Dokku-v0.14.6-blue.svg)\n\n# Run Sentry on Dokku\n\nDeploy your own instance of [Sentry](https://sentry.io) onto\n[Dokku](https://github.com/dokku/dokku)!\n\nThis project is a clone of the official bootstrap repository\n([getsentry/onpremise](https://github.com/getsentry/onpremise)) with a few\nmodifications for a seamless deploy to Dokku.\n\n## What you get\n\nThis repository will deploy [Sentry\n9.1](https://github.com/getsentry/sentry/releases/tag/9.1.0). It has been tested\nwith Dokku 0.10+.\n\n## Requirements\n\n * [Dokku](https://github.com/dokku/dokku)\n * [dokku-postgres](https://github.com/dokku/dokku-postgres)\n * [dokku-redis](https://github.com/dokku/dokku-redis)\n * [dokku-memcached](https://github.com/dokku/dokku-memcached)\n * [dokku-letsencrypt](https://github.com/dokku/dokku-letsencrypt)\n\n# Upgrading\n\nWhen upgrading to a newer version, e.g. 8.22 to 9.1.0, you just need to follow\nthe following steps:\n\nFirst get the newest version of this repository from GitHub and push it to you\nDokku host:\n\n```bash\ngit pull\ngit push dokku master\n```\n\nDuring the deploy, Dokku will run all commands that are necessary to upgrade the\ndatabase to the newest version. You do not need to do anything else.\n\n# Setup\n\nThis will guide you through the set up of a new Sentry instance. Make sure to\nfollow these steps one after another.\n\n## App and databases\n\nFirst create a new Dokku app. We'll call it `sentry`.\n\n```\ndokku apps:create sentry\n```\n\nNext we create the databases needed by Sentry and link them.\n\n```\ndokku postgres:create sentry_postgres\ndokku postgres:link sentry_postgres sentry\n\ndokku redis:create sentry_redis\ndokku redis:link sentry_redis sentry\n\ndokku memcached:create sentry_memcached\ndokku memcached:link sentry_memcached sentry\n```\n\n## Configuration\n\n### Set a secret key\n\n```\ndokku config:set --no-restart sentry SENTRY_SECRET_KEY=$(echo `openssl rand -base64 64` | tr -d ' ')\n```\n\n### Email settings\n\nIf you want to receive emails from sentry (notifications, activation mails), you\nneed to set the following settings accordingly.\n\n```\ndokku config:set --no-restart sentry SENTRY_EMAIL_HOST=smtp.example.com\ndokku config:set --no-restart sentry SENTRY_EMAIL_USER=\u003cyourusername\u003e\ndokku config:set --no-restart sentry SENTRY_EMAIL_PASSWORD=\u003cyourmailpassword\u003e\ndokku config:set --no-restart sentry SENTRY_EMAIL_PORT=25\ndokku config:set --no-restart sentry SENTRY_SERVER_EMAIL=sentry@example.com\ndokku config:set --no-restart sentry SENTRY_EMAIL_USE_TLS=True\n```\n\n## Persistent storage\n\nTo persists user uploads (e.g. avatars) between restarts, we create a folder on\nthe host machine and tell Dokku to mount it to the app container.\n\n```\nsudo mkdir -p /var/lib/dokku/data/storage/sentry\nsudo chown 32768:32768 /var/lib/dokku/data/storage/sentry\ndokku storage:mount sentry /var/lib/dokku/data/storage/sentry:/var/lib/sentry/files\n```\n\n## Domain setup\n\nTo get the routing working, we need to apply a few settings. First we set\nthe domain.\n\n```\ndokku domains:set sentry sentry.example.com\n```\n\nThe parent Dockerfile, provided by the sentry project, exposes port `9000` for\nweb requests. Dokku will set up this port for outside communication, as\nexplained in [its\ndocumentation](http://dokku.viewdocs.io/dokku/advanced-usage/proxy-management/#proxy-port-mapping).\nBecause we want Sentry to be available on the default port `80` (or `443` for\nSSL), we need to fiddle around with the proxy settings.\n\nFirst add the proxy mapping that sentry uses.\n\n```\ndokku proxy:ports-add sentry http:80:9000\n```\n\nThen, remove the proxy mapping added by Dokku.\n\n```\ndokku proxy:ports-remove sentry http:80:5000\n```\n\nIf `dokku proxy:report sentry` shows more than one port mapping, \nremove all port mappings except the added above.\n\n## Push Sentry to Dokku\n\n### Grabbing the repository\n\nFirst clone this repository onto your machine.\n\n#### Via SSH\n\n```\ngit clone git@github.com:mimischi/dokku-sentry.git\n```\n\n#### Via HTTPS\n\n```\ngit clone https://github.com/mimischi/dokku-sentry.git\n```\n\n### Set up git remote\n\nNow you need to set up your Dokku server as a remote.\n\n```\ngit remote add dokku dokku@example.com:sentry\n```\n\n### Push Sentry\n\nNow we can push Sentry to Dokku (_before_ moving on to the [next part](#domain-and-ssl-certificate)).\n\n```\ngit push dokku master\n```\n\n## SSL certificate\n\nLast but not least, we can go an grab the SSL certificate from [Let's\nEncrypt](https://letsencrypt.org/).\n\n```\ndokku config:set --no-restart sentry DOKKU_LETSENCRYPT_EMAIL=you@example.com\ndokku config:set --no-restart sentry SENTRY_USE_SSL=True\ndokku letsencrypt sentry\n```\n\n## Create a user\n\nSentry is now up and running on your domain ([https://sentry.example.com](#)).\nBefore you're able to use it, you need to create a user.\n\n```\ndokku run sentry sentry createuser\n```\n\nThis will prompt you to enter an email, password and whether the user should be a superuser.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmimischi%2Fdokku-sentry","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmimischi%2Fdokku-sentry","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmimischi%2Fdokku-sentry/lists"}