> ## Documentation Index
> Fetch the complete documentation index at: https://sentrydocs.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Project

> Set up a Sentry project and get your DSN.

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

<Steps>
  <Step title="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.
  </Step>

  <Step title="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)

    <Note>
      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.
    </Note>
  </Step>

  <Step title="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**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.

    <Tip>
      If you navigate away before copying, find your DSN at **Settings > Projects > \[your project] > Client Keys (DSN)**.
    </Tip>
  </Step>
</Steps>

## 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
```

| Part                               | Description                               |
| ---------------------------------- | ----------------------------------------- |
| `abc123def456789012345678901234ab` | Your public key (32-character hex string) |
| `o123456.ingest.sentry.io`         | Sentry's ingest endpoint for your region  |
| `7890123`                          | Your project ID                           |

<Warning>
  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**.
</Warning>

### 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:

```javascript theme={null}
Sentry.init({
  dsn: "https://<key>@<org>.ingest.sentry.io/<project>",
  environment: "production",
});
```

```python theme={null}
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.

<CardGroup cols={2}>
  <Card title="Quick Start" icon="rocket" href="/quickstart">
    Install the SDK and send your first event.
  </Card>

  <Card title="SDK Reference" icon="code" href="/sdk/overview">
    Detailed SDK configuration options for your platform.
  </Card>

  <Card title="Alerts" icon="bell" href="/concepts/alerts">
    Set up alert rules to get notified when issues occur.
  </Card>

  <Card title="DSN Keys" icon="key" href="/sdk/dsn-keys">
    Learn more about client keys, rotation, and rate limits.
  </Card>
</CardGroup>