Skip to main content
A project in Sentry represents a single monitored application or service — for example, your frontend web app, your backend API, or your mobile app. Each project has its own issues stream, DSN, alert rules, and settings. You can have multiple projects in one organization. Teams own projects, which determines who receives alerts and can manage issues.

​
Create a project

1

Open the project creation dialog

Go to Settings > Projects and click Create Project in the top right corner.Alternatively, click the + icon next to “Projects” in the left sidebar.
2

Choose your platform

Select the platform your application runs on. Sentry uses this to show you the correct SDK installation instructions and automatically configures sensible defaults for that language or framework.Sentry supports over 100 platforms, including:
  • JavaScript (Browser, Node.js, Next.js, React, Vue, Angular, and more)
  • Python (Django, Flask, FastAPI, and more)
  • Java / Kotlin (Spring, Android)
  • .NET (ASP.NET Core, MAUI, WPF)
  • Go, Elixir, Ruby, PHP, Rust
  • Mobile (iOS, Android, React Native, Flutter)
If your platform isn’t listed, select the closest match or choose the generic SDK for your language. You can update the platform setting later in project settings.
3

Set an alert frequency

Choose how you want to be notified about new issues:
  • Alert me on every new issue — Sends a notification for every new issue type Sentry first sees
  • When there are more than 10 occurrences — Reduces noise by requiring a minimum occurrence count
  • I’ll create my own alerts later — Skips the default rule; set up custom alert rules afterward
You can modify and add alert rules at any time from Settings > Alerts.
4

Name your project and assign a team

Give your project a descriptive name that identifies the application or service it monitors — for example, web-frontend, payments-api, or ios-app.Assign the project to a team. Team members receive alert notifications for the project and can manage its issues. You can assign a project to multiple teams.Click Create Project to finish.
5

Copy your DSN

After creating the project, Sentry displays the SDK setup instructions for your chosen platform, including your project’s DSN (Data Source Name).Copy the DSN. You’ll use it to initialize the Sentry SDK in your application.
If you navigate away before copying, find your DSN at Settings > Projects > [your project] > Client Keys (DSN).

​
Understanding your DSN

The DSN (Data Source Name) is a URL that tells the Sentry SDK where to send events. It encodes your public API key and your project ID. 
https://<public_key>@<host>/<project_id>
A real DSN looks like this: 
https://abc123def456789012345678901234ab@o123456.ingest.sentry.io/7890123
PartDescription
abc123def456789012345678901234abYour public key (32-character hex string)
o123456.ingest.sentry.ioSentry’s ingest endpoint for your region
7890123Your project ID
Treat your DSN as a write-only credential — it allows anyone who has it to send events to your project. It does not grant read access to your data or account. If your DSN is exposed publicly and you’re receiving spam events, you can rotate it under Settings > Projects > [project] > Client Keys.

​
Multiple client keys

A project can have more than one client key (DSN). This is useful if you want to:
  • Use separate keys for different environments (staging vs. production)
  • Set different rate limits per key
  • Rotate a compromised key without interrupting service
Manage client keys at Settings > Projects > [your project] > Client Keys (DSN).

​
Project settings overview

After creating a project, you can configure it under Settings > Projects > [your project].

​
Environments

Sentry automatically detects environments from the environment field in your SDK configuration. Common values are production, staging, and development. You can filter the issues stream and dashboards by environment to see only production errors or to compare behavior across environments. Set the environment in your SDK initialization: 
Sentry.init({
  dsn: "https://<key>@<org>.ingest.sentry.io/<project>",
  environment: "production",
});

sentry_sdk.init(
    dsn="https://<key>@<org>.ingest.sentry.io/<project>",
    environment="production",
)

​
Alert rules

Alert rules define when Sentry sends you a notification. You can create rules based on:
  • Issue frequency — Alert when an issue occurs more than N times in a time window
  • New issue — Alert the first time Sentry sees an issue
  • Regression — Alert when a resolved issue reappears
  • Performance — Alert when transaction durations or error rates exceed thresholds
Configure alert rules at Settings > Alerts > [your project].

​
Rate limits

Rate limits control how many events Sentry accepts per minute for a client key. Use rate limits to protect your quota during traffic spikes. Configure per-key rate limits at Settings > Projects > [your project] > Client Keys. You can also configure organization-wide rate limits at Settings > Security & Privacy > Rate Limits.

​
Next steps

Now that you have a project and DSN, install the SDK in your application.

Quick Start

Install the SDK and send your first event.

SDK Reference

Detailed SDK configuration options for your platform.

Alerts

Set up alert rules to get notified when issues occur.

DSN Keys

Learn more about client keys, rotation, and rate limits.