---
title: "Deploy Shiori"
description: "Bookmark manager that keeps readable offline copies of saved pages"
category: "Other"
url: https://railway.com/deploy/shiori-2
---

# Deploy Shiori

Bookmark manager that keeps readable offline copies of saved pages

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

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

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

## Template content

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

- **Source:** https://github.com/aalfath/shiori-railway-template
- **Health check:** /system/liveness
- **Public domain:** Yes

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

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

## Documentation

# Deploy and Host Shiori on Railway

Shiori is a simple, open-source (MIT) bookmark manager written in Go. You save links from the web UI, the browser extension or the API; Shiori fetches each page's title, excerpt and a readable copy, and can keep a full offline archive, so your bookmarks still work after the original page changes or disappears.

## About Hosting Shiori

This template deploys Shiori 1.8.0 (official image, pinned by version and digest) as two services. **Shiori** serves the web UI and API on a public HTTPS domain and keeps page archives, thumbnails and ebooks on a volume at `/shiori`. **Postgres** stores bookmarks, tags and accounts on its own volume and is reached over Railway's private network. Upstream Shiori creates a `shiori` / `gopher` owner account on every new database; this template replaces it with your own owner account and a generated password before the app is reachable, and refuses to start if it can't. The deploy form asks nothing. Health check: `/system/liveness`.

## Common Use Cases

* A private read-later list that replaces Pocket, Instapaper or Raindrop.io
* Keeping offline archives of articles, documentation and references against link rot
* A shared bookmark library for a small team, with tags and separate accounts

## Dependencies for Shiori Hosting

* Shiori service (built from [aalfath/shiori-railway-template](https://github.com/aalfath/shiori-railway-template)) with a volume for archives
* Railway PostgreSQL with its own volume

### Deployment Dependencies

* [Shiori on GitHub](https://github.com/go-shiori/shiori)
* [Shiori 1.8.0 release](https://github.com/go-shiori/shiori/releases/tag/v1.8.0)
* [Shiori configuration docs](https://github.com/go-shiori/shiori/blob/v1.8.0/docs/Configuration.md)
* [Shiori browser extension](https://github.com/go-shiori/shiori-web-ext)

### Implementation Details

After deploy:

1. Wait until both services are green, then open the Shiori service's public URL.
2. Log in with `SHIORI_ADMIN_USERNAME` (default `admin`) and `SHIORI_ADMIN_PASSWORD`, both in the Shiori service's **Variables** tab. They are used once, on the first start; change the password later in Shiori under the gear icon → *My account*.
3. Click **+** to save a link. Tick *Create archive* for an offline copy, or turn it on by default under the gear icon → *Bookmarks*. Add more users under *Accounts* (there is no public sign-up).

Shiori idles at a few MB of RAM and runs on Railway's Free plan (0.5 GB, 1 vCPU). If it stops unexpectedly it exits with an error, so Railway's restart policy brings it back.

Updates: when the template repo gets a new Shiori version, Railway shows you an "update available" notice and you choose when to apply it. Read the repo's `CHANGELOG.md` first. Shiori migrates its database on start, and your bookmarks and archives stay on their volumes.

## Why Deploy Shiori 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 Shiori 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/shiori-2
