Skip to content

Commit 2845b41

Browse files
committed
docs: Bring back self-signed cert docs and expand with reverse-proxy note
1 parent a8ccf74 commit 2845b41

File tree

1 file changed

+22
-0
lines changed
  • develop-docs/development/environment

1 file changed

+22
-0
lines changed

develop-docs/development/environment/index.mdx

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,28 @@ You can create other users with `sentry createuser`.
5555

5656
Please refer to [Frontend Development Server](/frontend/development-server/) and [Backend Development Server](/backend/development-server/) for alternative ways to bring up the Sentry UI.
5757

58+
### Enabling HTTPS
59+
60+
You may wish to run the development server over a secure HTTPS connection. This can be done by generating & installing local certificates and running a reverse proxy.
61+
62+
We will be using [mkcert](https://github.com/FiloSottile/mkcert) to create and install a locally-trusted, development certificate and [Caddy](https://caddyserver.com/) as our reverse proxy. The following will install `mkcert` and `caddy` and then create and install the local certificates, and run the server.
63+
64+
```shell
65+
brew install mkcert
66+
brew install nss # if you use Firefox
67+
brew install caddy
68+
yarn mkcert-localhost
69+
yarn https-proxy
70+
```
71+
72+
Now you can visit the dev server using `https` at port `:8003` instead of over `http` at `:8000`.
73+
74+
<Alert title="HTTP Strict-Transport-Security" level="info">
75+
You might get into a situation where [HSTS](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Strict-Transport-Security) is enabled for your domain and you're unable to visit using `http` anymore.
76+
77+
To clear the HSTS visit `chrome://net-internals/#hsts` in Chrome based browsers and use the "Delete domain security policies" form.
78+
</Alert>
79+
5880
### Ingestion Pipeline (Relay) aka Sending Events to your Dev Environment
5981

6082
<Link to="/services/relay/">Relay</Link> and the ingest workers are not started by default. Follow the instructions below to start them so you can send events to your dev environment Sentry instance:

0 commit comments

Comments
 (0)