Name: apprise-api
Availability: InStock
Author: koukyo_huang's Projects

Deploy and Host Apprise API on Railway

About Hosting

Apprise API is a lightweight REST framework built on Django and Gunicorn that wraps the Apprise Notification Library. It provides a unified API to send notifications to 120+ services (Slack, Telegram, Discord, Email, SMS, Pushover, etc.) from a single endpoint. The container runs Nginx + Gunicorn via Supervisord, exposing port 8000. Configuration and attachments are persisted to disk.

Why Deploy

Centralize all notification routing through a single self-hosted API endpoint
Avoid embedding notification provider credentials in every application
Built-in web UI for managing and testing notification configurations
Supports stateless one-shot notifications and stateful key-based configurations
Webhook remapping allows integration with third-party tools that send non-standard payloads
Prometheus /metrics endpoint for monitoring

Common Use Cases

Homelab alerting: send notifications from Home Assistant, Uptime Kuma, or other self-hosted tools through a central gateway
DevOps notifications: trigger alerts to Slack/Teams/PagerDuty from CI/CD pipelines via a simple REST call
Application sidecar: add notification capability to any app without bundling notification libraries
Multi-channel broadcasting: send the same message to multiple services simultaneously using tags

Dependencies for Deployment

Deployment Dependencies

Item	Value
Docker Image	`caronc/apprise:latest`
Container Port	`8000`
Volume	`/config` (persistent configuration storage)
`PORT`	`8000` — Railway routing target
`APPRISE_STATEFUL_MODE`	`simple` — maps configuration keys to files in `/config`
`APPRISE_WORKER_COUNT`	`1` — number of Gunicorn workers (sufficient for light use)
`APPRISE_ADMIN`	`y` — enables the web-based configuration UI
`TZ`	`Etc/UTC` — container timezone
`PUID`	`1000` — user ID for file permissions
`PGID`	`1000` — group ID for file permissions