Notifications

Truetask keeps you informed about things that matter — when you're assigned to a task, when someone mentions you, when a deadline is approaching. Notifications reach you three ways: in-app, browser push, and email.

The Notification Panel

Click the bell icon in the top toolbar to open the notification panel. A badge shows the count of unread notifications.

What You Get Notified About

Type	Triggered by
New Assignment	You're assigned to a task
Unassignment	You're removed from a task
New Comment	Someone comments on a task you're on or watching
@Mention	Someone mentions you in a description or comment
Task Completed	A task you're on is marked complete
Details Updated	A task you're watching has its title, description, or fields edited
New Attachment	A file is attached to your task
Board Invitation	You're added to a board
Overdue	A task you're on has passed its due date
Upcoming	A task is due within 7 days
Due Soon	A task is due within 1-2 days
Timer Auto-Stopped	Your running timer was stopped after 8 hours of inactivity

Each notification has a colored icon so you can scan them quickly.

Who gets notified?

You receive notifications when you're a member of a task or a watcher.

• Members are people explicitly assigned to the task
• Watchers get notifications without appearing on the member list — @mentioning someone or manually clicking the watch icon adds them

See Collaboration → Watchers for more.

Filtering

Use the category tabs at the top of the panel to narrow what you see:

• All — everything
• Comments — comment and reply activity
• Assignments — assignment changes
• Mentions — @mentions only
• Due Dates — overdue, upcoming, due soon
• System — timer auto-stops and other app events

Actions

• Click a notification to jump to the related task or board
• Mark read — click the unread dot
• Mark all read — header button
• Dismiss — remove a single notification
• Dismiss all — clear everything (with a confirmation)

Browser Push Notifications

Push notifications work even when Truetask isn't open. You'll get them as desktop alerts via your browser or OS.

How it works

Web push is a browser standard. Each browser ships with a built-in push service that holds a connection open and delivers messages to the right page:

• Chrome / Edge / Brave / Helium / Arc → Firebase Cloud Messaging (FCM, fcm.googleapis.com)
• Firefox → Mozilla autopush (autopush.services.mozilla.com)
• Safari → Apple Push Notification service (APNs, *.push.apple.com)

Truetask itself signs the messages with VAPID so the browser can verify they came from your server, but it cannot replace these push services — they're a hard dependency of the web platform. The message body is end-to-end encrypted to your browser, so the push service can't read your task content, but the connection itself does need to reach the relevant service.

Enable push

1. Open Profile from the user menu (bottom of the sidebar)
2. Go to Notifications
3. Toggle Push Notifications on
4. Click Allow on the browser permission prompt

Works out of the box in Chrome, Edge, Firefox, and Safari.

Disable push

From the same screen, toggle push off. If you want to revoke at the browser level, visit your browser's site settings for your Truetask URL.

Privacy-focused browsers

Some Chromium-based browsers ship with the push service disabled by default for privacy reasons (it normally connects to Google's FCM). On those browsers the toggle in Truetask will fail with "Your browser blocked the push service" even though notifications appear allowed in the site permissions.

Here's how to enable push messaging in the most common ones. Restart the browser after each change.

Brave

1. Visit brave://settings/privacy
2. Scroll to Use Google services for push messaging and turn it on
3. Restart Brave
4. Reload Truetask and toggle push on again

If you'd rather not enable Google services, Brave will not deliver web push. There's no Brave-side alternative.

Helium

1. Open Helium → Settings (or helium://settings)
2. Look under Privacy and security for Push messaging / Use Google services for push messaging and turn it on
3. Restart Helium
4. Reload Truetask and toggle push on again

Helium follows Brave's Chromium fork closely, so the setting is in the same general area. If you can't find it, check chrome://settings/privacy (Helium accepts the chrome:// URLs).

Arc

Arc enables push by default, but if you've hardened it via the Boost or extension, check arc://settings/privacy → Site settings → Notifications → Additional permissions and confirm push messaging isn't blocked.

Mullvad Browser, LibreWolf, Tor Browser

These browsers intentionally remove or sandbox the push service for anti-fingerprinting reasons. Web push will not work and there's no toggle to re-enable it. Use email notifications or a different browser for push.

Firefox forks (Waterfox, Pale Moon, etc.)

If push doesn't work, check about:config for dom.push.enabled and set it to true. Some forks also need dom.push.serverURL pointed at Mozilla's autopush (wss://push.services.mozilla.com/). Restart the browser after.

Still not working?

The most reliable way to confirm whether push is a browser issue or a Truetask issue: try the same Truetask URL in Safari (macOS/iOS) or stock Chrome (any OS). If push works there, the original browser is blocking the push service. If it fails everywhere, open an issue.

Email Notifications

When your administrator has configured SMTP, Truetask can send emails for critical events:

• Task assignments
• @Mentions
• Overdue reminders
• Board invitations

Turn email on or off

Open Profile → Notifications and toggle the email option per category. Changes apply immediately.

SMTP required

If email toggles are greyed out, your administrator hasn't configured SMTP yet. Ask them to set it up in Settings → Server → SMTP.

Personal Preferences

Profile → Notifications is where you customize everything:

Category	In-app	Push	Email
Assignments	✓	✓	✓
Mentions	✓	✓	✓
Due Dates	✓	✓	✓
Comments	✓	✓	—
System (timers, etc.)	✓	—	—

You can configure each row independently — get @mentions by email but assignments only in-app, for example.

Tips

• Watching without being assigned is the best way to keep tabs on work you care about without cluttering the members list
• Mark all read is your friend after a break — start fresh instead of scrolling through dozens of old notifications
• If you're getting too many notifications, tighten your preferences per category rather than turning everything off
• Push notifications are tied to the browser you enable them in — enable on multiple devices independently