MirrorNest
← All guides

Shaarli

Shaarli is a minimalist, database-free, self-hosted bookmarking and link-archiving service, officially shipped as a container image on GitHub Container Registry.

Target: Any Docker hostProductivityOfficial homepage ↗Official docs ↗
This guide is synthesized from Shaarli's own official documentation, linked above — always cross-check exact package/version names there before running these commands on a production server, since distro and project versions move over time.

  1. 1Create data directories

    mkdir -p /opt/shaarli/data /opt/shaarli/cache

  2. 2Run the Shaarli container

    docker run --detach --name myshaarli --publish 8000:80 --volume /opt/shaarli/data:/var/www/shaarli/data --volume /opt/shaarli/cache:/var/www/shaarli/cache ghcr.io/shaarli/shaarli:latest

  3. 3Docker Compose alternative (with reverse proxy)

    For a production setup with Traefik and automatic Let's Encrypt certificates, download the official compose file and configure the .env before starting.

    curl -L https://raw.githubusercontent.com/shaarli/Shaarli/latest/docker-compose.yml -o docker-compose.yml
    docker-compose up -d

    Set SHAARLI_VIRTUAL_HOST, SHAARLI_LETSENCRYPT_EMAIL and SHAARLI_DOCKER_TAG in .env before starting this variant.

  4. 4First login

    Open the site in a browser to create the initial account, since Shaarli has no separate registration step.

    Default access with the simple run command: http://your-server:8000