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

54 lines
2.8 KiB
Markdown
Raw Normal View History

# Sentry 10 On-Premise [![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
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! Everytime you run the install script, it will generate a log file, `sentry_install_log-<ISO_TIMESTAMP>.txt` with the output. Sharing these logs would help people diagnose any issues you might be having.
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. Remember that the output of the script will be stored in a log file, `sentry_install_log-<ISO_TIMESTAMP>.txt`, which you may share for diagnosis if anything goes wrong.
2016-05-28 00:52:58 +02:00
## Resources
* [Documentation](https://docs.sentry.io/server/)
* [Bug Tracker](https://github.com/getsentry/onpremise/issues)
2016-10-12 16:07:05 +02:00
* [Forums](https://forum.sentry.io/c/on-premise)
* [Discord](https://discord.gg/mg5V76F) (Sentry Community, #sentry-server)
[build-status-image]: https://api.travis-ci.com/getsentry/onpremise.svg?branch=master
[build-status-url]: https://travis-ci.com/getsentry/onpremise