Deploy Shaarli
Minimalist, database-free bookmark manager with tags, notes and feeds
Just deployed
/var/www/shaarli/data
Deploy and Host Shaarli on Railway
Shaarli is a personal, minimalist bookmarking service. You save links with a title, a Markdown note and tags, keep them public or private, and search, filter and share them through tag clouds, a daily digest and RSS/Atom feeds. It needs no database: everything is stored in flat files on disk.
About Hosting Shaarli
This template runs Shaarli v0.16.10 as one Railway service, built from the official image (pinned by version and digest) with a small wrapper. nginx and PHP-FPM serve it on a public HTTPS domain, and one volume holds the bookmarks, settings, thumbnails and login sessions, so a redeploy loses nothing. The admin account is created from SHAARLI_USERNAME (default admin) and a generated SHAARLI_PASSWORD before the site goes live, so Shaarli's install page is never exposed. After deploy, open the service's Variables tab, copy the password, open the URL and log in. It uses about 20 MB of RAM and fits Railway's free 0.5 GB.
Common Use Cases
- A private bookmark archive that replaces browser bookmarks across devices
- A public "links I'm reading" page with tag feeds others can follow
- A read-later list and notes log with private entries and a daily digest
Dependencies for Shaarli Hosting
- One Railway service built from aalfath/shaarli-railway-template
- One Railway volume at
/var/www/shaarli/data(no database needed)
Deployment Dependencies
- Shaarli source and releases: github.com/shaarli/Shaarli (v0.16.10)
- Official image: ghcr.io/shaarli/shaarli
- Documentation: shaarli.readthedocs.io
Implementation Details
- Service:
Shaarli, public, health check/healthz(answers without login once the volume is writable and the admin login exists). Restart policy: on failure; the wrapper exits with an error if nginx or PHP-FPM stops. - First login: username from
SHAARLI_USERNAME, password fromSHAARLI_PASSWORDin the service's Variables tab. Then set the title, timezone and privacy under Tools → Configure; those settings stay on the volume. - Forgot the password: change
SHAARLI_PASSWORDin Railway and redeploy. The admin login is reset; bookmarks and settings stay. - Behind Railway's proxy: the wrapper takes the visitor address from Railway's
X-Real-IP, so Shaarli's login ban and session protection work, and cookies are markedSecure. - Import: Tools → Import takes a Netscape bookmark file exported from any browser. Uploads up to 32 MB.
- Updates: Railway shows an update notice when the template repo moves to a new Shaarli release; the repo's CHANGELOG lists each change, breaking ones first.
Why Deploy Shaarli 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 Shaarli 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
