Deploy Shaarli

Minimalist, database-free bookmark manager with tags, notes and feeds

Deploy Shaarli

/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

Deployment Dependencies

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 from SHAARLI_PASSWORD in 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_PASSWORD in 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 marked Secure.
  • 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

More templates in this category

View Template
Rocky Linux
Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀

codestorm
51
View Template
Foundry Virtual Tabletop
Self-hosted virtual tabletop for role-playing games (license required)

Lucas
71
View Template
NEW
Double Commander in your browser
The Double Commander file manager in the cloud, from any device

Nermin Sabanovic
0