
Deploy Apprise API
Apprise API 1.5: one REST endpoint to notify 100+ services. Basic auth.
apprise
Just deployed
/config
Deploy and Host Apprise API on Railway
Apprise API is a small REST service that sends notifications to more than a hundred services with one request. Telegram, Discord, Slack, email, ntfy, Pushover, Microsoft Teams, Matrix and many more are addressed with simple URLs, so your apps need one integration instead of many.
About Hosting Apprise API
This template runs the official caronc/apprise:1.5.4 image as one service. Upstream Apprise API has no authentication, so the start command adds HTTP basic auth to its built-in nginx: every page and API call needs the user and password from the variables. Saved notification configurations live on a Railway volume and survive redeploys, so apps can call /notify/ without knowing the targets. Attachments from private network addresses are rejected. Apps in the same Railway project can use the private hostname with the same credentials. The service needs about 150 MB of memory and fits the Hobby plan.
Common Use Cases
- One notification endpoint for cron jobs, CI pipelines and scripts
- Sending alerts to several chat apps and email at once
- Keeping notification tokens in one place instead of every app
Dependencies for Apprise API Hosting
caronc/apprise:1.5.4(official image)- A Railway volume at
/configfor saved configurations
Deployment Dependencies
Implementation Details
| Service | Source | Networking | Storage |
|---|---|---|---|
| apprise | caronc/apprise:1.5.4 | public domain on 8000 | volume at /config |
| Variable | Default | Purpose |
|---|---|---|
APPRISE_AUTH_USER | apprise | Basic-auth user |
APPRISE_AUTH_PASSWORD | generated | Basic-auth password |
APPRISE_STATEFUL_MODE | simple | Stores configs as plain files per key |
APPRISE_ATTACH_REJECT_URL | 127.0.* localhost* internal | Blocks attachments from private addresses |
Notes:
- Save targets:
curl -u apprise: https:///add/alerts -d "urls=tgram:///". - Send:
curl -u apprise: https:///notify/alerts -d "body=Deploy finished". - There is no health check path, because every path needs credentials.
This is a community-maintained deployment package and does not imply affiliation with or endorsement by the Apprise project or Chris Caron.
Why Deploy Apprise API on Railway?
Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.
By deploying Apprise API on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.
Template Content
apprise
caronc/apprise:1.5.4