sentry
100M+
DEPRECATED; https://develop.sentry.dev/self-hosted/
docker pull sentry
This image is deprecated in favor of the full installation explained over at Self-Hosted Sentry Docs (last updated July 2019; getsentry/docker-sentry#189).
Maintained by:
Sentry
Where to get help:
the Docker Community Forums, the Docker Community Slack, or Stack Overflow
Dockerfile
linksNo supported tags
Where to file issues:
https://github.com/getsentry/docker-sentry/issues
Supported architectures: (more info)
No supported architectures
Published image artifact details:
repo-info repo's repos/sentry/
directory (history)
(image metadata, transfer size, etc)
Image updates:
official-images repo's library/sentry
label
official-images repo's library/sentry
file (history)
Source of this description:
docs repo's sentry/
directory (history)
Sentry is a realtime event logging and aggregation platform. It specializes in monitoring errors and extracting all the information needed to do a proper post-mortem without any of the hassle of the standard user feedback loop.
Start a Redis container
$ docker run -d --name sentry-redis redis
Start a Postgres container
$ docker run -d --name sentry-postgres -e POSTGRES_PASSWORD=secret -e POSTGRES_USER=sentry postgres
Generate a new secret key to be shared by all sentry
containers. This value will then be used as the SENTRY_SECRET_KEY
environment variable.
$ docker run --rm sentry config generate-secret-key
If this is a new database, you'll need to run upgrade
$ docker run -it --rm -e SENTRY_SECRET_KEY='<secret-key>' --link sentry-postgres:postgres --link sentry-redis:redis sentry upgrade
Note: the -it
is important as the initial upgrade will prompt to create an initial user and will fail without it
Now start up Sentry server
$ docker run -d --name my-sentry -e SENTRY_SECRET_KEY='<secret-key>' --link sentry-redis:redis --link sentry-postgres:postgres sentry
The default config needs a celery beat and celery workers, start as many workers as you need (each with a unique name)
$ docker run -d --name sentry-cron -e SENTRY_SECRET_KEY='<secret-key>' --link sentry-postgres:postgres --link sentry-redis:redis sentry run cron
$ docker run -d --name sentry-worker-1 -e SENTRY_SECRET_KEY='<secret-key>' --link sentry-postgres:postgres --link sentry-redis:redis sentry run worker
If you'd like to be able to access the instance from the host without the container's IP, standard port mappings can be used. Just add -p 8080:9000
to the docker run
arguments and then access either http://localhost:8080
or http://host-ip:8080
in a browser.
If you did not create a superuser during upgrade
, use the following to create one:
$ docker run -it --rm -e SENTRY_SECRET_KEY='<secret-key>' --link sentry-redis:redis --link sentry-postgres:postgres sentry createuser
When you start the sentry
image, you can adjust the configuration of the Sentry instance by passing one or more environment variables on the docker run
command line. Please note that these environment variables are provided as a jump start, and it's highly recommended to either mount in your own config file or utilize the sentry:onbuild
variant.
SENTRY_SECRET_KEY
A secret key used for cryptographic functions within Sentry. This key should be unique and consistent across all running instances. You can generate a new secret key doing something like:
$ docker run --rm sentry config generate-secret-key
SENTRY_POSTGRES_HOST
, SENTRY_POSTGRES_PORT
, SENTRY_DB_NAME
, SENTRY_DB_USER
, SENTRY_DB_PASSWORD
Database credentials for your Postgres server. These values aren't needed if a linked postgres
container exists.
SENTRY_REDIS_HOST
, SENTRY_REDIS_PORT
, SENTRY_REDIS_DB
Connection information for your Redis server. These values aren't needed if a linked redis
container exists.
SENTRY_MEMCACHED_HOST
, SENTRY_MEMCACHED_PORT
Connection information for a Memcache server. These values aren't needed if a linked memcached
container exists.
SENTRY_FILESTORE_DIR
Directory where uploaded files will be stored. This defaults to /var/lib/sentry/files
and is a VOLUME
for persistent data.
SENTRY_SERVER_EMAIL
The email address used for From:
in outbound emails. Default: root@localhost
SENTRY_EMAIL_HOST
, SENTRY_EMAIL_PORT
, SENTRY_EMAIL_USER
, SENTRY_EMAIL_PASSWORD
, SENTRY_EMAIL_USE_TLS
Connection information for an outbound smtp server. These values aren't needed if a linked smtp
container exists.
SENTRY_MAILGUN_API_KEY
If you're using Mailgun for inbound mail, set your API key and configure a route to forward to /api/hooks/mailgun/inbound/
.
View license information for the software contained in this image.
As with all Docker images, these likely also contain other software which may be under other licenses (such as Bash, etc from the base distribution, along with any direct or indirect dependencies of the primary software being contained).
Some additional license information which was able to be auto-detected might be found in the repo-info
repository's sentry/
directory.
As for any pre-built image usage, it is the image user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within.
Docker Official Images are a curated set of Docker open source and drop-in solution repositories.
These images have clear documentation, promote best practices, and are designed for the most common use cases.