Skip to content

Commit 10db65d

Browse files
authored
docs(self-hosted): specify correct noproxy values for docker config (#11371)
Closes getsentry/self-hosted#3300
1 parent 601041a commit 10db65d

File tree

1 file changed

+13
-12
lines changed

1 file changed

+13
-12
lines changed

develop-docs/self-hosted/index.mdx

Lines changed: 13 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ sidebar_order: 30
55

66
In addition to making its source code available publicly, Sentry offers and maintains a minimal setup that works out-of-the-box for simple use cases. This version comes with no guarantees or dedicated support. Sentry engineers will do their best to answer questions and are dedicated to making sure self-hosted is running, but that's where our involvement ends. For anything else, we expect users to rely on the [Sentry Self-Hosted community](https://discord.gg/sentry) on Discord. The self-hosted repository should serve as a blueprint for how various Sentry services connect for a complete setup. This will be useful for folks willing to maintain larger installations with custom infrastructure.
77

8-
For the sake of simplicity and ubiquity, we have chosen to use [Docker](https://www.docker.com/) and [Docker Compose](https://docs.docker.com/compose/), along with a bash-based install and upgrade script.
8+
For the sake of simplicity and ubiquity, we have chosen to use [Docker](https://www.docker.com/) and [Docker Compose](https://docs.docker.com/compose/), along with a bash-based install and upgrade script.
99

1010
If you're self-hosting Sentry and want to know how to switch to Sentry SaaS, check out this [live workshop](https://sentry.io/resources/migrate-to-sentry-saas-workshop/) to learn more about our relocation tooling.
1111

@@ -105,23 +105,24 @@ Environment="NO_PROXY=127.0.0.0/8"
105105

106106
From there you can run `./install.sh` like usual.
107107

108-
By default Sentry sends anonymous usage statistics to the Sentry team. It helps to improve the product. Also there can be different external integrations with third party services like Slack or Twilio. To make these features work it's required to allow Docker containers to access the Internet. To add your proxy environment variables into Sentry's Docker containers, create `~/.docker/config.json` with these contents:
108+
By default Sentry sends anonymous usage statistics to the Sentry team. It helps to improve the product. You can disable this feature by adding `SENTRY_BEACON = False` into `sentry.conf.py` file. Also there can be different external integrations with third party services like Slack or Twilio. To make these features work it's required to allow Docker containers to access the Internet. To add your proxy environment variables into Sentry's Docker containers, create `/etc/docker/config.json` file (or `~/.docker/config.json` if you're running Docker on rootless mode) with these contents:
109109

110110
```json
111111
{
112-
"proxies":
113-
{
114-
"default":
115-
{
116-
"httpProxy": "http://proxy:3128",
117-
"httpsProxy": "http://proxy:3128",
118-
"noProxy": "relay,web,sentry,127.0.0.0/8"
119-
}
120-
}
112+
"proxies": {
113+
"httpProxy": "http://proxy:3128",
114+
"httpsProxy": "http://proxy:3128",
115+
"noProxy": "smtp,memcached,redis,postgres,kafka,clickhouse,snuba-api,symbolicator,web,worker,nginx,relay,vroom,172.17.0.0/16,127.0.0.0/8"
116+
}
121117
}
122118
```
123119

124-
You can disable this feature by adding `SENTRY_BEACON = False` into `sentry.conf.py` file.
120+
To apply new Docker daemon configuration, restart your Docker service with `systemctl restart docker.service`.
121+
122+
<Alert title="Note" level="info">
123+
The value `172.17.0.0/16` is the default IP pools for Docker. If you are customizing your Docker default IP pools, please modify the value accordingly.
124+
Further information regarding Docker default IP pools can be found on the [Troubleshooting guide](/self-hosted/troubleshooting/#docker-network-conflicting-ip-address).
125+
</Alert>
125126

126127
## Errors-only Self-hosted Sentry
127128

0 commit comments

Comments
 (0)