Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
Self-host Shaarli
updated Nov 2026deployed by usprices checked · Jul 2026Install verified on Ubuntu 26.04 · Nov 2026 · how we test
We earn commissions when you shop through the links below. Full disclosure →
A personal bookmark manager and link-sharing service written in PHP, built for a single user. You save links (called Shaares) with a title, description and tags, mark them private or public, and can also post text-only notes. It has a bookmarklet for saving the current page, search and tag filtering, RSS and Atom feeds, a picture wall, and import and export of HTML bookmark files. It has no database: links and settings live in files under its data directory (a datastore file plus config.json.php), so backing up that folder backs up everything. A web installer asks for the login, password and timezone on first visit.
Pick Shaarli when you want a bookmark manager that is a small PHP application with no database to run: links, tags and settings are files in one data folder, so the whole install is a single container and a backup is a copy of a directory. You save links with a bookmarklet, keep them private or public, tag and search them, and publish feeds and a picture wall for the public ones. It is a one-person tool by design (one account), PHP with its own datastore, and the project's COPYING file lists zlib/libpng for its own code with separate terms for a bundled template engine and some assets, so GitHub reports the licence as Other. Our snippet adapts the Docker docs, pins `ghcr.io/shaarli/shaarli:v0.16.10` (released 2026-10-21, rebuilt on Alpine 3.24.2 for two PHP CVEs) instead of the `latest` tag the docs use, publishes port 8000 and keeps data and cache in named volumes. Choose linkding or Karakeep instead if you want multiple users, a database-backed search or page archiving; Shaarli stores only the link, not a copy of the page.
What you need
Any VPS with at least 256 MB of RAM
A domain you control — most self-hosted setups need HTTPS in front of them
Paid link — we earn a commission if you shop through it.
Install
Run these commands on your server:
# Shaarli — personal bookmark manager — adapted from the docs' docker run example into a compose file, pinned to the v0.16.10 image (the image bundles nginx and PHP-FPM; data and cache live in named volumes)cat > docker-compose.yml <<'EOF'services: shaarli: image: ghcr.io/shaarli/shaarli:v0.16.10 restart: unless-stopped ports: - "8000:80" volumes: - shaarli-data:/var/www/shaarli/data - shaarli-cache:/var/www/shaarli/cachevolumes: shaarli-data: shaarli-cache:EOFdocker compose up -dtimeout 120 bash -c 'until curl -fsS -o /dev/null http://localhost:8000/; do sleep 3; done'# → http://SERVER_IP:8000 — the Shaarli installer: choose a login, password and timezone to create the single account (whoever submits first owns the instance), then you land on the empty link list
Shaarli's docs, Dockerfile and COPYING file flag these before you rely on it:
non-negotiableThere is no default login. On first visit the installer asks whoever reaches it first for a login and password, and that becomes the owner account. Create it immediately after starting the container and keep port 8000 off the public internet until you have.
non-negotiableAll links, tags and settings live in /var/www/shaarli/data (the datastore and config.json.php). Our snippet keeps that in a named volume; back it up before changing the image tag. The upgrade guide says the configuration and datastore are migrated automatically the first time you open the new version.
non-negotiableThe docs' Docker page publishes latest (the master branch) and release as floating tags next to vX.Y.Z. Pin the version tag like we do; latest follows development and can change under you on a pull.
non-negotiableThe image serves plain HTTP on port 80. For anything beyond a trusted network put TLS in front: the repo's own docker-compose.yml adds a Traefik proxy with Let's Encrypt for this. Without HTTPS the login and session cookie travel in clear text.
non-negotiableThe licence is not a single standard text. COPYING declares zlib/libpng for Shaarli's own code, but lists the bundled RainTPL template engine (inc/rain.tpl.class.php) under LGPL-3+, other third-party files under BSD, MIT and CC-BY terms, and some public-domain images, so check it if you redistribute a modified build.
non-negotiableThe security settings in config.json.php ban an IP after repeated failed logins (the configuration docs show ban_after 4 and ban_duration 1800 seconds). Behind a reverse proxy, the docs say to list the proxy's address under trusted_proxies so it is not banned itself.
Shaarli used 16 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.3 (first boot, measured Nov 2026). We list a minimum of 256 MB.
Is the Shaarli install snippet verified?
The Shaarli install snippet is marked verified on Ubuntu 26.04 (Nov 2026).