96 lines
3.2 KiB
Markdown
96 lines
3.2 KiB
Markdown
---
|
|
title: Apprise
|
|
created: 2026-06-08
|
|
updated: 2026-06-08
|
|
type: app
|
|
tags: [catalogue, notifications, python, app-marathon-batch-rattrapage-3]
|
|
confidence: high
|
|
contested: false
|
|
sources: [https://selfh.st/apps/?tag=Notifications, https://github.com/caronc/apprise]
|
|
---
|
|
|
|
# 🔔 Apprise
|
|
|
|
> **API unifiée pour envoyer des notifications vers 100+ services** : Slack, Discord, Telegram, email, SMS, push, webhooks, etc.
|
|
|
|
## 📋 Informations Générales
|
|
|
|
| Champ | Valeur |
|
|
| :--- | :--- |
|
|
| **Site web** | [github.com/caronc/apprise](https://github.com/caronc/apprise) |
|
|
| **GitHub** | [caronc/apprise](https://github.com/caronc/apprise) |
|
|
| **License** | MIT |
|
|
| **Langage** | Python |
|
|
| **Étoiles GitHub** | 13k ⭐ |
|
|
| **Catégorie** | [[cat-notifications|Notifications]] |
|
|
|
|
## 📝 Description
|
|
|
|
**Apprise** est une bibliothèque Python et un microservice qui **abstrait l'envoi de notifications** vers une centaine de services (Slack, Discord, Telegram, Matrix, email, Twilio, Pushover, Ntfy, Gotify, webhooks génériques, MQTT…). Sa force : **une seule URL** au format `scheme://` décrit la cible, indépendante du service.
|
|
|
|
**Différence avec Ntfy/Gotify** : Apprise est un **agrégateur client** (il *envoie* vers d'autres services), alors que Ntfy et Gotify sont des **serveurs de notification push** (ils *reçoivent*). Apprise est complémentaire, pas concurrent direct.
|
|
|
|
**Pour qui** : développeurs et admins qui veulent **une seule intégration** au lieu de coder 10 SDK différents.
|
|
|
|
## 🚀 Installation
|
|
|
|
### Docker Compose (recommandé)
|
|
|
|
```yaml
|
|
version: '3.8'
|
|
services:
|
|
apprise-api:
|
|
image: caronc/apprise:latest
|
|
container_name: apprise
|
|
restart: unless-stopped
|
|
ports:
|
|
- "8000:8000"
|
|
volumes:
|
|
- apprise-config:/config
|
|
labels:
|
|
- "traefik.enable=true"
|
|
- "traefik.http.routers.apprise.rule=Host(`apprise.example.com`)"
|
|
- "traefik.http.routers.apprise.entrypoints=websecure"
|
|
- "traefik.http.routers.apprise.tls.certresolver=letsencrypt"
|
|
|
|
volumes:
|
|
apprise-config:
|
|
```
|
|
|
|
### Utilisation CLI
|
|
|
|
```bash
|
|
# Envoyer vers plusieurs services en une commande
|
|
apprise -b "Backup terminé" \
|
|
slack://TokenA/TokenB/Channel \
|
|
tgram://bottoken/chatid \
|
|
mail://user:pass@smtp.example.com
|
|
```
|
|
|
|
## 🔄 Alternatives
|
|
|
|
### Open Source
|
|
- [[app-ntfy]] — Serveur push simple
|
|
- [[app-gotify]] — Serveur push avec apps mobiles
|
|
- [[app-argus]] — Agrégateur multi-sources
|
|
|
|
### Propriétaires
|
|
- **Pushover** (5 USD unique) — Push mobile populaire
|
|
- **OneSignal** — Push mobile/web SaaS
|
|
|
|
## 🔐 Sécurité
|
|
- **Authentification basique** sur l'API : définir `APPRISE_STATELESS_URLS` pour tokens stateless.
|
|
- **API key par service** : chaque provider conserve ses credentials en variable d'env ou DB chiffrée (`/config`).
|
|
- **Pas d'exposition publique** recommandée : à déployer en backend derrière Traefik + auth.
|
|
|
|
## 📚 Ressources
|
|
- [Documentation](https://github.com/caronc/apprise/wiki)
|
|
- [Liste des services supportés](https://github.com/caronc/apprise#supported-notifications)
|
|
- [API REST](https://github.com/caronc/apprise-api)
|
|
|
|
## Pages Liées
|
|
- [[cat-notifications]] — Catégorie Notifications
|
|
- [[app-ntfy]] — Push simple
|
|
- [[app-gotify]] — Push mobile
|
|
- [[recettes-docker-compose]] — Templates Docker
|