What is Lyftr?
A workout tracker you run yourself. Log sessions from reusable programs, follow a guided Gym Mode
with a rest timer, and keep nutrition and bodyweight next to your training. Everything you log
lives in a single SQLite file on your server.
No subscription, no cloud account, nothing to export: the database is already yours.
Features
| |
|---|
| Workouts | Exercise library of 800+ exercises with photos and instructions, from open-exercise-db, a program builder, and set-by-set logging with a rest timer |
| Gym Mode | One exercise at a time with large controls; a focused dialog on desktop, full screen on a phone |
| Progress | Personal bests and a weight-progression chart per exercise, a muscle diagram, and a dashboard with volume trend, muscle balance and a 12-week consistency heatmap |
| Nutrition | Calories and macros against your own targets, food search and barcode scanning (via Open Food Facts), macro trends |
| Weight | Bodyweight log with a trend chart, in lbs or kg |
| Everywhere | One app: a sidebar layout on desktop, a tab bar on phones, and an Android build. Light and dark themes, English and Spanish |
| Yours | Self-hosted with Docker on amd64, arm64 or armv7. One SQLite file, and registration you can leave open, limit to the first user, or close |
Quick start
No clone, no build, just Docker:
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
# set JWT_SECRET in .env to a long random string (openssl rand -hex 32), then:
docker compose pull && docker compose up -d
Open http://localhost and create your account. The compose file defaults to
REGISTRATION=first-user: your signup claims the instance and everyone after is refused. Read
locking down registration
to move to closed once you have signed up.
Portainer
In Portainer, open Settings > App Templates, set the URL to
https://raw.githubusercontent.com/Cawlumm/lyftr/main/deploy/portainer/templates.json
and save. Lyftr then appears under App Templates: fill in a JWT secret and deploy. The
stack (deploy/portainer/docker-compose.yml) keeps its
data in the lyftr-data volume, publishes the web app on port 8080, starts with registration
limited to the first user, and pulls the stable image tag, which follows releases. stable
is published from the first release after v0.1.0-beta.9; before that, set the image tag field
to v0.1.0-beta.9.
The docs cover the rest:
configuration,
HTTPS and reverse proxies,
backups and updates,
the Android app and
troubleshooting.
Try it
- Live demo: lyftr-demo.fly.dev. One tap signs you in, or use
[email protected] / password123. It resets hourly. That account exists only on the demo;
your own install has no default login.
- Android: download the APK from the newest
release and point it at your server (mobile docs).
- iOS: planned, and blocked on an Apple Developer account rather than on the code (see
Support).
Status
Beta. Lyftr is actively built and every release is published as a prerelease, so expect rough
edges and frequent updates. Back up data/lyftr.db before you upgrade
(how). The software equivalent of going to the gym for
the first time.
Tech stack
Go · Gin · SQLite for the API. One Expo / React Native app in TypeScript with NativeWind, exported
to the web through react-native-web and served by nginx. Astro · Starlight for the docs. Docker
Compose to run it.
The exercise catalog comes from open-exercise-db,
a sister project: an open, community-maintained exercise database with public-domain (CC0) data.
Each Lyftr install keeps a local copy, synced daily from its static snapshot.
Translations
Lyftr ships in English and Spanish. Help translate it into your language: see
CONTRIBUTING.md.
Contributing
Bug reports, feature requests, translations, and PRs are welcome. Open an issue before large
changes. Start with CONTRIBUTING.md for setup and conventions, and
docs/TESTING.md for how the test suite is organised.
A wrong or missing exercise is fixed in
open-exercise-db, so the fix
reaches every app that uses it.
Support
Lyftr is free and open source under the MIT license. Run it on your own hardware, no subscription.
The most useful things you can do are free: file a reproducible bug report, fix a doc page that was
wrong, or tell another self-hoster it exists.
If you'd rather help with the running costs, sponsorship covers the demo server (~$4/month) and the
developer accounts Lyftr needs to reach more platforms. The iOS app is blocked on a $99/year Apple
Developer account, not on the code.
Sponsor on GitHub · All the ways to help
License
MIT
