From fc6de6ed63677f94351d8783e2f7e909628466f4 Mon Sep 17 00:00:00 2001 From: Chad Whitacre Date: Tue, 28 Jun 2022 18:02:05 -0400 Subject: [PATCH 1/2] Document self-hosted installation behind a proxy --- src/docs/self-hosted/index.mdx | 36 ++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/src/docs/self-hosted/index.mdx b/src/docs/self-hosted/index.mdx index 5488926f37..bb7336778c 100644 --- a/src/docs/self-hosted/index.mdx +++ b/src/docs/self-hosted/index.mdx @@ -8,6 +8,42 @@ In addition to making its source code available publicly, Sentry offers and main Our recommendation is to download the [latest release of the self-hosted repository](https://github.com/getsentry/self-hosted/releases/latest), and then run `./install.sh` inside this directory. This script will take care of all the things you need to get started, including a base-line configuration, and then will tell you to run `docker-compose up -d` to start Sentry. Sentry binds to port `9000` by default. You should be able to reach the login page at [http://127.0.0.1:9000](http://127.0.0.1:9000/). +### Installing Behind a Proxy + +In some enterprise setups there is no direct Internet connection, you must use an HTTP proxy server. How do you install Sentry in this environment? Let us assume: + +1. Your Sentry installation is running on Linux. +1. `http://proxy:3128` is your proxy address. +1. `127.0.0.0/8` is the only network that should be accessed without a proxy. + +Here are the steps to follow: + +1. Set `http_proxy`, `https_proxy` and `no_proxy` variables in the `/etc/environment` file. +2. To make the `docker pull` command respect your proxy settings, create a `/etc/systemd/system/docker.service.d/http-proxy.conf` file with these contents: +``` +[Service] +Environment="HTTP_PROXY=http://proxy:3128" +Environment="HTTPS_PROXY=http://proxy:3128" +Environment="NO_PROXY=127.0.0.0/8" +``` +3. Run `systemctl daemon-reload` and restart Docker with `systemctl restart docker.service`. +4. To add your proxy environment variables into Sentry's Docker containers, create `~/.docker/config.json` with these contents: +```json +{ + "proxies": + { + "default": + { + "httpProxy": "http://proxy:3128", + "httpsProxy": "http://proxy:3128", + "noProxy": "127.0.0.0/8" + } + } +} +``` + +From there you can run `./install.sh` like usual. + ## Configuration You very likely will want to adjust the default configuration for Sentry. These facilities are available for that purpose: From f8703394e6c0cabc1920fd544526182f30087ec1 Mon Sep 17 00:00:00 2001 From: Chad Whitacre Date: Wed, 29 Jun 2022 09:43:15 -0400 Subject: [PATCH 2/2] Add word Co-authored-by: Ethan Smith --- src/docs/self-hosted/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/docs/self-hosted/index.mdx b/src/docs/self-hosted/index.mdx index bb7336778c..e372b58b2a 100644 --- a/src/docs/self-hosted/index.mdx +++ b/src/docs/self-hosted/index.mdx @@ -10,7 +10,7 @@ Our recommendation is to download the [latest release of the self-hosted reposi ### Installing Behind a Proxy -In some enterprise setups there is no direct Internet connection, you must use an HTTP proxy server. How do you install Sentry in this environment? Let us assume: +In some enterprise setups there is no direct Internet connection, so you must use an HTTP proxy server. How do you install Sentry in this environment? Let us assume: 1. Your Sentry installation is running on Linux. 1. `http://proxy:3128` is your proxy address.