Skip to content

armgit / lyftr

Public Imported from GitHub
0

Self-hosted fitness tracker. Log workouts, track nutrition, and monitor progress. Docker deployment, mobile-friendly.

2.6 KB
Raw Blame

title: Self-Hosting description: Run your own Lyftr instance in one Docker command — on a VPS, Raspberry Pi, or NAS.

Lyftr runs anywhere Docker does. No clone, no build, no Go install — just Docker.

Quick start

Download the compose file and an env template:

curl -o docker-compose.yml https://raw.githubusercontent.com/Cawlumm/lyftr/main/docker-compose.yml
curl -o .env https://raw.githubusercontent.com/Cawlumm/lyftr/main/.env.example

Edit .env and set a strong JWT_SECRET (32+ characters), then pull the prebuilt images and start:

docker compose pull
docker compose up -d

Open http://localhost in your browser and create your account. On a VPS, replace localhost with your server's IP or domain.

:::note[Why pull first] The compose file references prebuilt images on Docker Hub. Running docker compose pull fetches them so nothing is built locally — you don't need the source code, just the compose file and .env. :::

:::caution[Close the door behind you] Registration is open by default, so anyone who can reach your instance can create an account. That is fine on a LAN and wrong once it has a public hostname. Set REGISTRATION=first-user in .env before the first up -d to claim the instance with your own signup, then move to REGISTRATION=closed once you have — see Locking down registration for why the second step matters. :::

:::tip[Exercise library] On first startup Lyftr downloads the whole 800+ exercise catalog from open-exercise-db in the background — no API key, no setup — and refreshes it every 24 hours. It needs outbound HTTPS to do that. See Exercise Library. :::

Where it runs

Tested and working on:

  • Raspberry Pi 4 (2 GB RAM, arm64 image)
  • Any x86 VPS — Hetzner CAX11, DigitalOcean Droplet, Oracle Free Tier
  • Synology NAS via Docker (Container Manager)
  • Proxmox LXC with Docker installed
  • Local machine — Mac, Linux, Windows (WSL2)

Single SQLite file, minimal RAM, no external services required.

Next steps