How do I deploy apprise-api on Railway?

You can deploy apprise-api on Railway by clicking the "Deploy Now" button on this page. Railway will automatically set up all the necessary services and configurations for you.

What are the system requirements?

Railway handles all the infrastructure requirements. You only need a web browser to deploy and manage your application.

Is this template free to use?

Yes, this template is free to use within your existing Railway account.

Can I customize this template?

Yes, you can fully customize this template. After deployment, you will have full control of what you've deployed in your Railway project.

How do I get support for this template?

You can get support through our community forum: apprise-api-a3a20248, or click "Get template help" for this template for more assistance.

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