---
title: "Deploy Password Pusher"
description: "Share passwords, files and URLs via links that expire. Postgres included."
category: "Authentication"
url: https://railway.com/deploy/password-pusher
---

# Deploy Password Pusher

Share passwords, files and URLs via links that expire. Postgres included.

**[Deploy Password Pusher on Railway](https://railway.com/template/password-pusher)**

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

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

## Template content

### Password Pusher https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/png/passwordpusher.png

- **Source:** https://github.com/aalfath/password-pusher-railway-template
- **Health check:** /up
- **Public domain:** Yes

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

## Documentation

# Deploy and Host Password Pusher on Railway

Password Pusher (pwpush) is an open-source app for sharing passwords, text, files, URLs and QR codes through links that expire after a set number of days or views. Payloads are encrypted at rest, and every view is recorded in an audit log. It offers a web UI and a JSON API.

## About Hosting Password Pusher

This template runs Password Pusher 2.17.4 from the official `pglombardo/pwpush` image, pinned by version and digest, built through the repository `aalfath/password-pusher-railway-template`. It has two services. The app service runs the web server and the background worker that expires and purges pushes. A Railway PostgreSQL service holds users, encrypted pushes, audit logs and the job queue. Uploaded files go on a volume. The deploy form asks for nothing. Railway generates the encryption key, the Rails secret and a one-time boot code for the first admin account. Database migrations run on every start. The app runs within Railway's 0.5 GB per-service memory limit.

## Common Use Cases

* Send a password, API key or recovery code to a colleague or customer with a link that expires after one view or a few days
* Share sensitive files and URLs without leaving copies in chat or e-mail history
* Run an internal, self-hosted alternative to pwpush.com, with an audit log of who viewed each push and when

## Dependencies for Password Pusher Hosting

* PostgreSQL (Railway's PostgreSQL service, included)
* A Railway volume for uploaded files (included)

### Deployment Dependencies

* Password Pusher source and releases: https://github.com/pglombardo/PasswordPusher (v2.17.4)
* Self-hosted configuration reference: https://docs.pwpush.com/docs/self-hosted-configuration/
* Template repository: https://github.com/aalfath/password-pusher-railway-template

### Implementation Details

Services:

* `Password Pusher`: the public web app and API on port 5100 (Thruster in front of Puma), plus the Solid Queue worker in the same container. Volume at `/opt/PasswordPusher/storage`. Health check `/up`.
* `Postgres`: Railway's PostgreSQL, private network only, on its own volume.

After deploy:

1. Open the app's URL. The first visit goes to `/first_run`.
2. Copy `PWP_FIRST_RUN_BOOT_CODE` from the Password Pusher service's Variables tab, and use it to create the administrator account.
3. Anyone can create pushes without an account (upstream default). Set `PWP__ALLOW_ANONYMOUS=false` to require a login, and `PWP__DISABLE_SIGNUPS=true` to stop new sign-ups.

Optional: SMTP for account e-mails and password resets (`PWP__MAIL__SMTP_ADDRESS`, `PWP__MAIL__SMTP_USER_NAME`, `PWP__MAIL__SMTP_PASSWORD`, then `PWP__ENABLE_USER_ACCOUNT_EMAILS=true`). If you add a custom domain, set `PWP__HOST_DOMAIN` to it. Never change `PWPUSH_MASTER_KEY` once pushes exist, or they become unreadable.

Updates: the app service builds from the template repository. When it moves to a new Password Pusher release, Railway shows you an update notice. Read `CHANGELOG.md`, then apply it. Migrations run automatically.

## Why Deploy Password Pusher 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 Password Pusher 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

- [Keycloak](https://railway.com/deploy/mSwigX) — [2026-11-04] Keycloak with keywind theme + Apple & Discord providers
- [lua-protector](https://railway.com/deploy/lua-protector) — Test deployed my project first
- [bknd](https://railway.com/deploy/p4nTYL) — Feature-rich yet lightweight backend

Open this page in a browser: https://railway.com/deploy/password-pusher
