---
title: "Deploy ntfy"
description: "Self-hosted push notifications to phone and desktop over plain HTTP"
category: "Automation"
url: https://railway.com/deploy/ntfy-2
---

# Deploy ntfy

Self-hosted push notifications to phone and desktop over plain HTTP

**[Deploy ntfy on Railway](https://railway.com/template/ntfy-2)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/ntfy-2/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Automation

## Template content

### ntfy https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/ntfy.png

- **Source:** https://github.com/aalfath/ntfy-railway-template
- **Health check:** /v1/health
- **Public domain:** Yes

## Documentation

# Deploy and Host ntfy on Railway

ntfy is an open-source push notification service. You send a message to a topic with a plain HTTP PUT or POST, from a script, a cron job, a server or any app, and it shows up on your phone (Android and iOS apps) or in your browser. No sign-up with a third-party service is needed.

## About Hosting ntfy

ntfy is a single Go binary with a small footprint. This template runs the official `binwiederhier/ntfy` image (v2.38.0, pinned by digest) on one Railway service with a public domain. The message cache, the user database and file attachments are SQLite files and folders on a Railway volume, so they survive redeploys. Access control is on from the start: every topic needs a login, and an admin account is created from a generated password, so there's no default password and nothing to fill in at deploy time. Railway handles HTTPS, and the health check uses ntfy's `/v1/health` endpoint.

## Common Use Cases

* Alerts from scripts, cron jobs, backups and CI pipelines straight to your phone
* Notifications from self-hosted apps and monitoring tools (Uptime Kuma, Grafana, Home Assistant, Healthchecks and others support ntfy)
* A private, self-hosted alternative to Pushover or Pushbullet for a person, a team or a family

## Dependencies for ntfy Hosting

* The ntfy server ([binwiederhier/ntfy](https://hub.docker.com/r/binwiederhier/ntfy), v2.38.0)
* A Railway volume for the SQLite databases and attachments (included)

### Deployment Dependencies

* ntfy documentation: https://docs.ntfy.sh
* Self-hosting and configuration reference: https://docs.ntfy.sh/config/
* Releases: https://github.com/binwiederhier/ntfy/releases
* Template source: https://github.com/aalfath/ntfy-railway-template

### Implementation Details

After the deploy, open the service's **Variables** tab to read `NTFY_ADMIN_PASSWORD`, then log in to the web app at your Railway domain with the user `admin`. Publish a test message:

```sh
curl -u admin:YOUR-PASSWORD -d "Backup finished" https://YOUR-DOMAIN/alerts
```

In the Android or iOS app, add your server URL and the same credentials, then subscribe to a topic. Notes:

* `NTFY_ADMIN_PASSWORD` is the source of truth: change it and redeploy to change the password.
* To let anyone subscribe without a login, set `NTFY_AUTH_DEFAULT_ACCESS=read-only`. More users, access rules and tokens can be provisioned with `NTFY_AUTH_USERS`, `NTFY_AUTH_ACCESS` and `NTFY_AUTH_TOKENS`, or with `ntfy user` and `ntfy access` in the service shell.
* Optional features are off until you set them: email notifications (`NTFY_SMTP_SENDER_*`) and browser push (`NTFY_WEB_PUSH_*`). See the configuration reference.
* Instant notifications on iOS go through `https://ntfy.sh` as the upstream server (only a message ID is sent). Set `NTFY_UPSTREAM_BASE_URL` to an empty value to turn this off.
* Updates: the template builds from its GitHub repo. New ntfy versions are merged there with a changelog entry, and Railway shows you an "update available" notice that you apply when you choose.

## Why Deploy ntfy 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 ntfy 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.



## Similar templates

- [N8N Main + Worker](https://railway.com/deploy/n8n-main-worker) — Deploy and Host N8N with Inactive worker.
- [Evolution API with n8n](https://railway.com/deploy/evolution-api-with-n8n) — Automate WhatsApp workflows with Evolution API, n8n, and Postgres.
- [Postgres Backup](https://railway.com/deploy/postgres-s3-backups) — Cron-based PostgreSQL backup to bucket storage

Open this page in a browser: https://railway.com/deploy/ntfy-2
