Skip to content
This repository was archived by the owner on Aug 14, 2024. It is now read-only.

Commit cb88821

Browse files
authored
Document self-hosted installation behind a proxy (#622)
1 parent df4674f commit cb88821

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

src/docs/self-hosted/index.mdx

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,42 @@ In addition to making its source code available publicly, Sentry offers and main
88

99
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/).
1010

11+
### Installing Behind a Proxy
12+
13+
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:
14+
15+
1. Your Sentry installation is running on Linux.
16+
1. `http://proxy:3128` is your proxy address.
17+
1. `127.0.0.0/8` is the only network that should be accessed without a proxy.
18+
19+
Here are the steps to follow:
20+
21+
1. Set `http_proxy`, `https_proxy` and `no_proxy` variables in the `/etc/environment` file.
22+
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:
23+
```
24+
[Service]
25+
Environment="HTTP_PROXY=http://proxy:3128"
26+
Environment="HTTPS_PROXY=http://proxy:3128"
27+
Environment="NO_PROXY=127.0.0.0/8"
28+
```
29+
3. Run `systemctl daemon-reload` and restart Docker with `systemctl restart docker.service`.
30+
4. To add your proxy environment variables into Sentry's Docker containers, create `~/.docker/config.json` with these contents:
31+
```json
32+
{
33+
"proxies":
34+
{
35+
"default":
36+
{
37+
"httpProxy": "http://proxy:3128",
38+
"httpsProxy": "http://proxy:3128",
39+
"noProxy": "127.0.0.0/8"
40+
}
41+
}
42+
}
43+
```
44+
45+
From there you can run `./install.sh` like usual.
46+
1147
## Configuration
1248

1349
You very likely will want to adjust the default configuration for Sentry. These facilities are available for that purpose:

0 commit comments

Comments
 (0)