Skip to content

feat(notifications): Implement unified notification center (ntfy + Apprise)#304

Closed
HuiNeng6 wants to merge 1 commit intoillbnm:masterfrom
HuiNeng6:feature/notifications-issue-13
Closed

feat(notifications): Implement unified notification center (ntfy + Apprise)#304
HuiNeng6 wants to merge 1 commit intoillbnm:masterfrom
HuiNeng6:feature/notifications-issue-13

Conversation

@HuiNeng6
Copy link

Summary

Implements the unified notification center as specified in Issue #13.

Changes Made

1. ntfy Server Configuration

  • File: config/ntfy/server.yml
  • Configured base URL, authentication, caching, and rate limiting
  • Ready for production use with security defaults

2. Alertmanager Integration

  • File: config/alertmanager/alertmanager.yml
  • Added ntfy webhook receivers for critical and warning alerts
  • Automatic notification routing based on severity

3. Unified Notification Script

  • File: scripts/notify.sh
  • Simple interface: notify.sh <topic> <title> <message> [priority]
  • Support for authenticated topics via NTFY_TOKEN

4. Comprehensive Documentation

  • File: stacks/notifications/README.md
  • Integration guides for all required services:
    • Alertmanager (webhook receiver)
    • Watchtower (notification URL)
    • Gitea (webhook integration)
    • Home Assistant (ntfy integration)
    • Uptime Kuma (Apprise/webhook)
  • Mobile app setup instructions
  • Troubleshooting guide

5. Docker Compose Updates

  • File: stacks/notifications/docker-compose.yml
  • Added config file mounts for ntfy
  • Connected to monitoring network for Alertmanager integration
  • Added TLS cert resolver labels

Acceptance Criteria

Criteria Status
ntfy Web UI accessible Configured with Traefik
Mobile app can receive test push Docs provided
notify.sh script works Implemented
Alertmanager alerts to ntfy Configured
Watchtower updates to ntfy Docs provided
README integration guides Complete

Testing

# Start the stack
cd stacks/notifications
docker compose up -d

# Test notification
./scripts/notify.sh homelab-test "Test" "Hello World"

Files Changed

  • config/ntfy/server.yml (new)
  • config/alertmanager/alertmanager.yml (modified)
  • stacks/notifications/docker-compose.yml (modified)
  • stacks/notifications/README.md (new)
  • scripts/notify.sh (new)
  • .env.example (modified)

Closes #13


Bounty: $80 USDT
Wallet: 0x742d35Cc6634C0532925a3b844Bc454e4438f44e

…+ Apprise

- Add ntfy server configuration (config/ntfy/server.yml)
- Configure Alertmanager to send alerts to ntfy webhooks
- Create unified notification script (scripts/notify.sh)
- Add comprehensive README with integration guides for:
  - Alertmanager
  - Watchtower
  - Gitea
  - Home Assistant
  - Uptime Kuma
- Update docker-compose.yml with config mounts and monitoring network
- Update .env.example with notification variables

Closes illbnm#13
@zhuzhushiwojia
Copy link

🦞 Claiming This Bounty!

Claiming the $80 USDT bounty for Notifications stack.

Delivery:

  • ntfy server configuration
  • Alertmanager webhook integration
  • Unified notify.sh script
  • Complete README with integration guides

Wallet: USDT TRC20: TMLkvEDrjvHEUbWYU1jfqyUKmbLNZkx6T1

Let me know if you need any modifications! 🚀

@HuiNeng6
Copy link
Author

👋 I have already submitted PR #304 with a complete notification center implementation:\n\n- Unified notification center with ntfy + Apprise\n- Multi-channel support\n- Full configuration\n\nWould appreciate a review from the maintainer!

@HuiNeng6
Copy link
Author

Closing duplicate PR - see #305 for the main implementation

@HuiNeng6 HuiNeng6 closed this Mar 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[BOUNTY $80] Notifications — 统一通知中心 (Gotify + Apprise)

2 participants