---
title: "Deploy Shaarli"
description: "Minimalist, database-free bookmark manager with tags, notes and feeds"
category: "Other"
url: https://railway.com/deploy/shaarli-1
---

# Deploy Shaarli

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

**[Deploy Shaarli on Railway](https://railway.com/template/shaarli-1)**

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

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

## Template content

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

- **Source:** https://github.com/aalfath/shaarli-railway-template
- **Health check:** /healthz
- **Public domain:** Yes

## Documentation

# 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](https://github.com/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](https://github.com/shaarli/Shaarli) ([v0.16.10](https://github.com/shaarli/Shaarli/releases/tag/v0.16.10))
* Official image: [ghcr.io/shaarli/shaarli](https://github.com/shaarli/Shaarli/pkgs/container/shaarli)
* Documentation: [shaarli.readthedocs.io](https://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 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.



## 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/shaarli-1
