55 lines
2.1 KiB
Markdown
55 lines
2.1 KiB
Markdown
# Sentry On-Premise [![Build Status][build-status-image]][build-status-url]
|
|
|
|
Official bootstrap for running your own [Sentry](https://sentry.io/) with [Docker](https://www.docker.com/).
|
|
|
|
## Requirements
|
|
|
|
* Docker 17.05.0+
|
|
* Compose 1.17.0+
|
|
|
|
## Minimum Hardware Requirements:
|
|
|
|
* You need at least 3GB 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 `docker-compose.yml` file 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.
|
|
|
|
The recommended way to customize your configuration is using the files below, in that order:
|
|
|
|
* `config.yml`
|
|
* `sentry.conf.py`
|
|
* `.env` w/ environment variables
|
|
|
|
If you have any issues or questions, our [Community Forum](https://forum.sentry.io/c/on-premise) is at your service!
|
|
|
|
## Securing Sentry with SSL/TLS
|
|
|
|
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 to add this service to your `docker-compose.yml` file.
|
|
|
|
## Updating Sentry
|
|
|
|
Updating Sentry using Compose is relatively simple. Just use the following steps to update. Make sure that you have the latest version set in your Dockerfile. Or use the latest version of this repository.
|
|
|
|
Use the following steps after updating this repository or your Dockerfile:
|
|
```sh
|
|
docker-compose build --pull # Build the services again after updating, and make sure we're up to date on patch version
|
|
docker-compose run --rm web upgrade # Run new migrations
|
|
docker-compose up -d # Recreate the services
|
|
```
|
|
|
|
## Resources
|
|
|
|
* [Documentation](https://docs.sentry.io/server/installation/docker/)
|
|
* [Bug Tracker](https://github.com/getsentry/onpremise/issues)
|
|
* [Forums](https://forum.sentry.io/c/on-premise)
|
|
* [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
|