2
0
This repository has been archived on 2020-07-19. You can view files and clone it, but cannot push or open issues or pull requests.
sentry-onpremise/README.md

56 lines
3.0 KiB
Markdown
Raw Normal View History

# Sentry 10 On-Premise BETA [![Build Status][build-status-image]][build-status-url]
2016-05-28 00:52:58 +02:00
2016-10-12 16:07:05 +02:00
Official bootstrap for running your own [Sentry](https://sentry.io/) with [Docker](https://www.docker.com/).
2016-05-28 00:52:58 +02:00
**NOTE:** If you are not installing Sentry from scratch, our recommendation is to visit [On-Premise Stable for Sentry 9.1.2](https://github.com/getsentry/onpremise/tree/stable) as this version may not be fully backward compatible. If you still want to try it out make sure you are on 9.1.2 first, back up your old Docker volumes just in case, and remember that if you haven't set up Redis persistency yourself some of your data (like your stats) may be lost during the upgrade.
2016-05-28 01:18:52 +02:00
## Requirements
* Docker 17.05.0+
* Compose 1.19.0+
## Minimum Hardware Requirements:
* You need at least 2400MB RAM
## Setup
To get started with all the defaults, simply clone the repo and run `./install.sh` in your local check-out.
There may need to be modifications to the included example config files (`sentry/config.example.yml` and `sentry/sentry.conf.example.py`) to accommodate your needs or your environment (such as adding GitHub credentials). If you want to perform these, do them before you run the install script and copy them without the `.example` extensions in the name (such as `sentry/sentry.conf.py`) before running the `install.sh` script.
The recommended way to customize your configuration is using the files below, in that order:
* `config.yml`
* `sentry.conf.py`
* `.env` w/ environment variables
We currently support a very minimal set of environment variables to promote other means of configuration.
If you have any issues or questions, our [Community Forum](https://forum.sentry.io/c/on-premise) is at your service!
2016-10-14 04:48:17 +02:00
## Event Retention
Sentry comes with a cleanup cron job that prunes events older than `90 days` by default. If you want to change that, you can change the `SENTRY_EVENT_RETENTION_DAYS` environment variable in `.env` or simply override it in your environment. If you do not want the cleanup cron, you can remove the `sentry-cleanup` service from the `docker-compose.yml`file.
2016-10-14 05:16:43 +02:00
## Securing Sentry with SSL/TLS
2016-10-14 04:48:17 +02:00
2016-10-14 05:16:43 +02:00
If you'd like to protect your Sentry install with SSL/TLS, there are
fantastic SSL/TLS proxies like [HAProxy](http://www.haproxy.org/)
and [Nginx](http://nginx.org/). You'll likely want to add this service to your `docker-compose.yml` file.
2016-10-14 04:48:17 +02:00
## Updating Sentry
The included `install.sh` script is meant to be idempotent and to bring you to the latest version. What this means is you can and should run `install.sh` to upgrade to the latest version available.
2016-05-28 00:52:58 +02:00
## Resources
2016-10-12 16:07:05 +02:00
* [Documentation](https://docs.sentry.io/server/installation/docker/)
* [Bug Tracker](https://github.com/getsentry/onpremise/issues)
2016-10-12 16:07:05 +02:00
* [Forums](https://forum.sentry.io/c/on-premise)
2016-05-28 00:52:58 +02:00
* [IRC](irc://chat.freenode.net/sentry) (chat.freenode.net, #sentry)
[build-status-image]: https://api.travis-ci.com/getsentry/onpremise.svg?branch=master
[build-status-url]: https://travis-ci.com/getsentry/onpremise