Documentation
Getting started
This guide takes you from zero to a first encrypted snapshot in about five minutes.
Install the agent
The agent is a single static binary for Linux, macOS and Windows.
# Linux / macOS
curl -fsSL https://my-media-doc.space/install.sh | sh
# Windows (PowerShell)
iwr https://my-media-doc.space/install.ps1 -useb | iex
Connect a workspace
Create an agent token in Settings → Agents, then run:
kelvra login --token <AGENT_TOKEN>
The encryption key is derived locally from your workspace passphrase. We never receive it.
First sync
kelvra add ./projects --name projects --retention 365d
kelvra sync projects
The agent keeps running as a background service and syncs changes within seconds.
CLI reference
add <path>: register a foldersync [name]: run a sync immediatelyhistory <file>: list versions of a filerestore <file> --at <snapshot>: restore a versionlimits --up 20M --schedule "Mo-Fr 08-18": bandwidth limits
REST API
The API lives under https://api.my-media-doc.space/v1 and uses bearer tokens with scopes.
curl -H "Authorization: Bearer $TOKEN" \
https://api.my-media-doc.space/v1/snapshots?folder=projects&limit=20
Retention
Each folder has its own retention policy. Expired snapshots are pruned nightly. On Business plans, buckets can be made immutable for a fixed period.