Notifications

Isurus can tell you when something happens in a repository you care about, such as a failed CI pipeline, a new pull request, or a release. It also tells you when someone asks something of you: assigns you an issue or requests your review.

Notifications are available only when a site administrator has turned them on (see Administration Guide — Notifications). While they are off, you won't see the repository bell or the notification settings page.

Channels

A channel is how a notification reaches you. Isurus offers:

Channel	Where it arrives
Email	Your primary email address.
Desktop	Browser notifications, in each browser where you have enabled them.

You only see the channels your administrator has turned on. If no channel is on yet, the settings show "No notification channel is turned on for this forge yet."

For every event you pick, you choose which channels it uses. For example, you can get failed pipelines by both Email and Desktop, and new releases by Email only.

Subscribing to a Repository

Each repository has a bell at the right of its menu. A filled bell means notifications are on for that repository; an outlined bell means they are off.

1. Open the repository and click the bell.
2. The Notify me about dialog shows the events in this repository, grouped into cards: CI pipelines, Pushes, Pull requests, Issues, and Releases.
3. Each event has one checkbox per channel. Tick the channels you want for each event. All and None tick or clear a whole column.
4. Choose whether to Include my own actions (see below).
5. Click Save.

More options in the dialog opens the repository's full notification page, which has the same choices and a link to all your notification settings.

Events you can pick

Group	Events
CI pipelines	Started, Failed, Fixed (passed after a failure), Succeeded, Cancelled
Pushes	Pushes to any branch
Pull requests	Opened, Merged, Review requested from me, Comments
Issues	Opened, Assigned to me, Comments, Closed
Releases	New release published

Include my own actions

When Include my own actions is on, your own activity notifies you too. For example, a CI pipeline you start tells you when it starts, fails, or finishes. Turn it off if you only want to hear about what other people do.

Muting a repository

If you save the dialog with nothing ticked, the repository is muted: it sends you nothing at all, not even issues assigned to you or reviews requested from you. Your notification settings list it as "Muted". To undo a mute, open the bell again and tick the events you want, or click Unsubscribe on the settings page to go back to the defaults for things asked of you.

Things Asked of Me

Open Settings → Notifications and find Things asked of me. These choices cover two personal events:

• Assigned to me — someone assigns you an issue.
• Review requested from me — someone asks you to review a pull request.

They apply in repositories you do not subscribe to, so you hear about work asked of you without subscribing to everything else in that repository. Email is on by default for both. A repository you subscribe to uses its own choices instead.

Your Notification Settings

Settings → Notifications lists everything on the forge that notifies you:

• Desktop — enable Desktop notifications in the current browser (see below).
• Channels — the channels available to you. Email goes to your primary address.
• Things asked of me — the personal events described above.
• Repositories — every repository you subscribe to, with its events, channels, and whether own actions are on. Click Edit to change a row or Unsubscribe to remove it.

To add a repository, use the bell on that repository.

Enabling Desktop Notifications

Desktop notifications are turned on per browser. Your Desktop choices save to your account, but notifications arrive only in browsers you have enabled.

1. In the browser you want to use, open Settings → Notifications (or a repository's bell dialog).
2. Click Enable on this browser and allow notifications when the browser asks.
3. The button changes to On in this browser.

Repeat this in every browser where you want Desktop notifications. If the browser says notifications are blocked for this site, allow them in the browser's site settings and try again. Some browsers can't show desktop notifications at all.

Why You Got a Notification

Every notification ends with a line saying why it was sent and links back to where you can change it. For example:

• "You were notified because you subscribe to pushes in acme/web."
• "You were notified because you were assigned this issue."
• "You were notified because your review was requested."
• "You were notified because your notification settings include your own actions."

Account security notices, such as a changed password, a new SSH key, or a new API token, are always sent by email and can't be turned off.