Notifications

Notifications

SharedMoments supports three notification channels. Each user can enable their preferred channels in the settings.

---

Push Notifications

Push notifications work out of the box — no configuration needed.

When a user opens SharedMoments for the first time, the browser will ask for notification permission. Once granted, push notifications are delivered directly to the browser or phone.

---

Email

Server Configuration

Add the SMTP environment variables to your docker-compose.yml:

environment:
  - SMTP_HOST=smtp.example.com
  - SMTP_PORT=587
  - SMTP_USER=notifications@example.com
  - SMTP_PASS=your-email-password
  - SMTP_FROM=notifications@example.com   # optional, defaults to SMTP_USER

User Setup

Each user enables email notifications in their personal settings and provides their email address.

---

Telegram

1. Create a Bot

1. Open Telegram and start a chat with @BotFather
2. Send /newbot and follow the prompts
3. Copy the bot token you receive

2. Configure the Server

Add the token to your docker-compose.yml:

environment:
  - TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrsTUVwxyz

3. User Setup

Each user enables Telegram notifications in their settings. They need to start a chat with the bot and provide their Chat ID in the settings.

To get your Chat ID, you can message the bot and it will respond with your ID, or use @userinfobot.

---

Per-User Channel Selection

Each user chooses which notification channels they want to receive. This is configured in the user's personal settings page.

Available options:

• Push notifications (on/off)
• Email notifications (on/off, requires email address)
• Telegram notifications (on/off, requires Chat ID)