# Notifications

The NVIDIA Run:ai platform provides multiple notification options to keep administrators and users informed of important events and updates. Administrators can enable any combination of the following methods:

* **Email notifications** - Delivered through a configured SMTP server
* **Slack notifications** - Integrated with your Slack workspace for real-time notifications
* **System notifications** - Displayed directly in the NVIDIA Run:ai interface for all users

## Email Notifications

You can configure an SMTP server to send email notifications from the system. This allow users to receive email notifications and set their own preferences via the [User settings](/self-hosted/2.24/settings/user-settings/notifications.md).

1. Go to **General settings** and navigate to Notifications -> Email notifications
2. Click **+EMAIL SERVER**
3. Enter SMTP server details
   * **SMTP host** - Enter your mail server hostname (e.g., `smtp.mail.com`)
   * **Port** - Enter the port number
4. Select **Authentication type**
   * **Plain** - Use a plain username/password authentication
   * **Login** - Use login authentication
   * **None** - No authentication required (not recommended)
5. Provide authentication details (if required)
   * **Username** - Enter the account username
   * **Password** - Enter the account password
6. Define email information
   * **From email address** - Enter the address to appear in the “From” field of notifications (e.g., `runai@company.com`)
   * **From display name** - Enter the sender display name (e.g., `Run:ai Notification`)
7. Click **VERIFY**
   * The system checks connectivity and credentials
   * If verification fails, correct the values and retry
8. Click **SAVE** to apply

## Slack Notifications

You can connect your Slack workspace to NVIDIA Run:ai to receive real-time notifications in designated Slack channels. To allow users to receive Slack notifications and set their own preferences via the user settings, first connect your Slack workspace.

1. Go to **General settings** and navigate to Notifications -> Slack notifications
2. Click **CONNECT SLACK WORKSPACE**. A new browser window will open, prompting you to sign in to Slack.
3. Select the Slack workspace you want to connect
4. Authorize NVIDIA Run:ai to post messages on behalf of your workspace

Once authorization is complete, the UI will show the connected workspace name and a **Status: Connected** indicator. You can also see a **DISCONNECT** button if you need to remove.

## System Notifications

System notifications allow administrators to broadcast custom messages that are displayed to all users. Notifications appear immediately to currently signed-in users and upon login for new sessions.

1. Go to **General settings** and navigate to Notifications -> System notification
2. Click **+ MESSAGE**
3. In the text editor, type the message to display
4. (Optional) Select the checkbox **Display "Don't show this again"** to allow users to dismiss the notification permanently
5. Click **SAVE & PUBLISH**

## Using APIs

To view the available actions, see the [Notification Channels](https://run-ai-docs.nvidia.com/api/2.24/notifications/notificationchannels) API reference.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://run-ai-docs.nvidia.com/self-hosted/2.24/settings/general-settings/notifications.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
