Documentation
Everything needed to run Papyra yourself. If you are in a hurry, the whole install is two commands.
curl -O https://raw.githubusercontent.com/lyfie-org/papyra/main/docker-compose.hub.yml
docker compose -f docker-compose.hub.yml up -d
# then open http://localhost:8080Getting started
Install Papyra
One compose file, one command. Papyra is a single container, with an optional model sidecar for the assistant.
Configuration
Every environment variable Papyra reads, what it is for, and when you actually need it. Most people need none of them.
HTTPS and reverse proxies
Why sessions and passkeys need real HTTPS, a working Caddy and nginx config, and what to tell Papyra about your proxy.
Living with it
Working with the files directly
Papyra is not the only thing allowed to touch your notes. How to use Obsidian, Syncthing, git or a text editor alongside it without anything getting confused.
Backups and git
Four ways to get your notes out — copying the folder, zip export, encrypted archives, and an automatic git mirror.
Importing your notes
Bringing a vault in from Obsidian or Google Keep, dragging in single files, or simply copying Markdown into the folder.
In depth
The assistant and semantic search
Papyra runs a model on your own hardware by default. How to install one, how much machine it needs, and how to use a hosted provider instead.
Sharing and mentions
Public links that expire, sharing with someone on your server, and what exactly a mention gives away.
People, invites and SSO
Adding people to your server, sending invites and password resets, and pointing Papyra at an identity provider.