Deploy Shiori
Bookmark manager that keeps readable offline copies of saved pages
Just deployed
/shiori
Just deployed
/var/lib/postgresql/data
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) with a volume for archives
- Railway PostgreSQL with its own volume
Deployment Dependencies
Implementation Details
After deploy:
- Wait until both services are green, then open the Shiori service's public URL.
- Log in with
SHIORI_ADMIN_USERNAME(defaultadmin) andSHIORI_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. - 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.
Template Content
