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

# Email notifications

> The platform emails you when something you care about happens: a deploy failed, came back, or went live, an org is close to its spend limit, or one of its build runners went offline.

## What you get by default

| Event | Default |
| - | - |
| Production deploy failed, partly failed, recovered | Mine |
| Production deploy live | Off |
| Preview deploy failed, partly failed, recovered, live | Off |
| Spend limit at 80%, spend limit reached | Mine |
| Runner offline or back online | Mine |

Each event is **Off**, **Mine** or **All**:

* **Mine**, for deploys: the deploys you started, and every deploy of projects in orgs where you're an admin or owner. For billing and runners: the orgs where you're an admin or owner.
* **All**: every project and org you're a member of.

"Recovered" is the first deploy that goes live after a failed or partial one; you get it instead of the "live" email.

Only verified email addresses get notifications. You only ever get emails about orgs you're a member of.

## Change them

* **Your defaults**: in the **Notifications** tab of the **Account** page. **Reset to defaults** brings back the table above.
* **One project**: in the project's **Settings** tab. Turn off **Use my defaults** and pick per event. Only you see these.

## Unsubscribe

Every email ends with an unsubscribe link. It turns that event off for that project (or, for billing and runner emails, in your defaults), so other projects keep notifying you. Mail apps that show an unsubscribe button use the same link.

## Bursts

If several things happen at once, say ten previews failing within a minute, you get the first email right away and the rest together in one digest a minute later.

## Self-hosting

Notifications need accounts (a database) and use the same SMTP settings as sign-up emails. Without SMTP they are written to the server log. See [Settings](https://docs.servers.dev/self-hosting/settings.md#email-notifications).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.