---
title: "Deploy wallabag"
description: "Read-it-later app (Pocket alternative) with Postgres and Redis imports"
category: "Other"
url: https://railway.com/deploy/wallabag-2
---

# Deploy wallabag

Read-it-later app (Pocket alternative) with Postgres and Redis imports

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

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

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

## Template content

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

- **Source:** https://github.com/aalfath/wallabag-railway-template
- **Health check:** /api/info
- **Public domain:** Yes

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

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

### Redis https://cdn.sanity.io/images/sy1jschh/production/0ce0bfdcfbdbf69662b1116671f97c2dd788b655-157x157.svg

- **Image:** redis:8.2
- **Start command:** `/bin/sh -c "rm -rf $RAILWAY_VOLUME_MOUNT_PATH/lost+found/ && exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --save 60 1 --dir $RAILWAY_VOLUME_MOUNT_PATH"`

## Documentation

# Deploy and Host wallabag on Railway

[wallabag](https://wallabag.org) is an open-source (MIT) read-it-later app. Save any web page and wallabag keeps a clean, readable copy of the article, with tags, annotations, full-text search and exports (EPUB, PDF and more). It has Android and iOS apps, browser extensions and e-reader support, and imports from Pocket, Instapaper, Omnivore and others.

## About Hosting wallabag

wallabag is a PHP (Symfony) app served by nginx and PHP-FPM. It needs a SQL database, a writable folder for article images, and a queue with a worker for large imports. This template deploys wallabag 2.6.18 from the official image with Railway Postgres and Railway Redis on the private network. On the first deploy it installs the database and creates your admin account with a generated password, so the well-known `wallabag` / `wallabag` login never works. Later deploys run the database migrations. Imports run in the background through Redis. Article images and sessions are stored on a volume, so they survive redeploys.

## Common Use Cases

* Replace Pocket or Omnivore: import your export and keep reading on your own server
* Save articles from your phone or browser and read them later on a Kobo, KOReader or any e-reader
* Keep a searchable, tagged archive of everything you've read, with annotations

## Dependencies for wallabag Hosting

* PostgreSQL: users, articles, tags and settings (Railway Postgres, included)
* Redis: background import queue (Railway Redis, included)

### Deployment Dependencies

* wallabag: [GitHub](https://github.com/wallabag/wallabag), [2.6.18 release](https://github.com/wallabag/wallabag/releases/tag/2.6.18), [documentation](https://doc.wallabag.org)
* Official Docker image: [wallabag/docker](https://github.com/wallabag/docker)
* Template source: [aalfath/wallabag-railway-template](https://github.com/aalfath/wallabag-railway-template)

### Implementation Details

The template deploys three services:

| Service | What it does | Storage |
|---|---|---|
| wallabag | Web app (nginx + PHP-FPM) and the Redis import worker, built from the template repo | Volume at `/data` (article images, sessions) |
| Postgres | Database | Volume |
| Redis | Import queue | Volume |

After deploy:

1. Open the wallabag service's public URL.
2. Log in as `admin` with the `ADMIN_PASSWORD` shown in the wallabag service's **Variables** tab. Change it under **Config → Password**, and set your email under **Config → User information**.
3. For the mobile apps, create an API client under **Developer → Create a new client**.

Optional variables you can add to the wallabag service:

* `SYMFONY__ENV__MAILER_DSN`, for example `smtp://USER:PASSWORD@smtp.example.com:587`, plus `SYMFONY__ENV__FROM_EMAIL` (email is off by default)
* `SYMFONY__ENV__FOSUSER_REGISTRATION=true` to allow public sign-up (needs email)
* With a custom domain, set `SYMFONY__ENV__DOMAIN_NAME` to `https://YOUR-DOMAIN`

Updates: the wallabag service builds from the template's GitHub repo. When a new wallabag version is added there, Railway shows an "update available" notice on your project, and you choose when to apply it. Read the repo's CHANGELOG first. Migrations run on the next start.

## Why Deploy wallabag 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 wallabag 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

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — Self-hosted virtual tabletop for role-playing games (license required)
- [Double Commander in your browser](https://railway.com/deploy/double-commander-in-your-browser) — The Double Commander file manager in the cloud, from any device

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