Self-Hosted Sentry

The CLI works with self-hosted Sentry instances. Set the SENTRY_HOST (or SENTRY_URL) environment variable to point at your instance:

export SENTRY_HOST=https://sentry.example.com

Authenticating

With OAuth (Sentry 26.1.0+)

The OAuth device flow requires Sentry 26.1.0 or later and a public OAuth application registered on your instance.

1. Create a Public OAuth Application

1. In your Sentry instance, go to Settings → Developer Settings → Applications → Create New Application (or visit https://sentry.example.com/settings/account/api/applications/)
2. Select Public as the application type
3. Fill in the required fields (name, redirect URL — can be any placeholder URL)
4. Save the application and copy the Client ID

2. Log In

Pass your instance URL and the client ID:

SENTRY_HOST=https://sentry.example.com SENTRY_CLIENT_ID=your-client-id sentry auth login

Tip

You can export both variables in your shell profile so every CLI invocation picks them up:

export SENTRY_HOST=https://sentry.example.com
export SENTRY_CLIENT_ID=your-client-id

With an API Token

If your instance is on an older version or you prefer not to create an OAuth application, you can use an API token instead:

1. Go to Settings → Developer Settings → Personal Tokens in your Sentry instance (or visit https://sentry.example.com/settings/account/api/auth-tokens/new-token/)
2. Create a new token with the following scopes:

project:read, project:write, project:admin, org:read, event:read, event:write, member:read, team:read, team:write

3. Pass it to the CLI:

SENTRY_HOST=https://sentry.example.com sentry auth login --token YOUR_TOKEN

After Login

Once authenticated, the CLI stores your instance URL — you don't need to set SENTRY_URL on every command. All subsequent commands automatically use the correct instance:

sentry issue list
sentry org list

If you pass a self-hosted Sentry URL as a command argument (e.g., an issue or event URL), the CLI detects the instance automatically.

Relevant Environment Variables

Variable	Description
SENTRY_HOST	Base URL of your Sentry instance (takes precedence over SENTRY_URL)
SENTRY_URL	Alias for SENTRY_HOST
SENTRY_CLIENT_ID	Client ID of your public OAuth application
SENTRY_ORG	Default organization slug
SENTRY_PROJECT	Default project slug (supports org/project format)

See Configuration for the full environment variable reference.