Running a Local Relay

Set up a local Relay instance for SDK development and testing.

You do not need a local Sentry instance for SDK development, but you will want to run a local Relay. Sentry's main ingestion endpoint is designed for high-throughput production use — event processing happens after acceptance, so you won't see errors in the HTTP response during development.

If you haven't used Relay yet, see the Relay getting started docs. Once installed, turn up the log level in your .relay/config.yml:

Copied
logging:
  level: trace

Copied
relay run

When sending events, substitute orgXXX.ingest.sentry.io with localhost:3000 (or whichever port you chose).

Note that a local Relay is available via HTTP only by default — do not send HTTPS requests to it.

Was this helpful?
Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").