Self-hosted fitness tracker. Log workouts, track nutrition, and monitor progress. Docker deployment, mobile-friendly.
title: HTTPS & Reverse Proxy description: Put Lyftr behind Caddy or nginx with automatic HTTPS (Let's Encrypt) for a public, secure instance.
Lyftr's container serves plain HTTP on a host port. Put it behind a reverse proxy that terminates HTTPS — this is the recommended setup for every install, not just public ones. Your login token travels on every request, and on plain HTTP anyone else on the network can read it.
If Lyftr never leaves your LAN you can still have a genuine, publicly-trusted certificate with no ports open to the internet — see LAN-only below.
:::caution[Port conflict]
By default the compose file publishes Lyftr on host port 80 (PORT=80). A reverse proxy also
wants 80/443, so first move Lyftr to a different host port — set PORT=8080 in your .env — and
point the proxy at localhost:8080.
:::
Caddy (easiest — automatic HTTPS)
Caddy fetches and renews Let's Encrypt certificates for you. A one-line
Caddyfile:
lyftr.example.com {
reverse_proxy localhost:8080
}
Then reload Caddy. That's it — HTTPS is live and auto-renewing.
nginx + Certbot
server {
server_name lyftr.example.com;
location / {
proxy_pass http://localhost:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
}
Then issue a certificate with Certbot:
sudo certbot --nginx -d lyftr.example.com
LAN-only? Get a real certificate anyway (recommended)
If Lyftr never leaves your network, you can still have a genuine, publicly-trusted certificate — no ports open to the internet. Use a domain you own, point a record at a private address, and let Caddy prove ownership over DNS instead of HTTP:
lyftr.home.example.com {
tls {
dns cloudflare {env.CF_API_TOKEN}
}
reverse_proxy localhost:8080
}
This is the best option by a distance: every device trusts it out of the box, nothing is exposed, and renewal is automatic. It needs a domain you control and a DNS provider with an API — Caddy's DNS provider modules cover most of them.
Private CA / self-signed certificates
If you have no domain and must use your own CA, the mobile app can work with it, but there are rules that trip people up:
- Install the CA on the device, not just the server. On Android: Settings → Security → Encryption & credentials → Install a certificate → CA certificate. On iOS: install the profile, then enable it under Settings → General → About → Certificate Trust Settings.
- The certificate must carry a Subject Alternative Name. A Common Name alone has not
been accepted for years. If you connect by IP, the IP must be in the SAN as an
IP Addressentry — aDNSentry will not match. - Use RSA ≥ 2048 or EC ≥ 256, SHA-256 or better, and TLS 1.2+.
- Use a current Android build. The app trusts the device's user-installed CA store; older builds ignored it entirely and reported that they couldn't reach the server even though the server was fine. If a private CA isn't working, update the app first.
Your own CA is enough for the web app's barcode scanner too — browsers grant camera access
based on the page being https://, not on who issued the certificate. You don't need a
publicly-trusted certificate for that, though you do need the CA installed so the browser
stops warning.
:::caution[Plain HTTP is an escape hatch, not a setup]
Android blocks unencrypted HTTP by default. The Lyftr Android app opts back in, so
http://<lan-ip>:8080 works for a standard docker compose install — otherwise the
documented quick-start would be unusable on a phone. But understand what you're accepting:
Nothing is encrypted. Every request carries your login token in the clear, so anyone else
on that network can read it and stay signed in as you — on a home LAN that includes guests
and any compromised device. Captured tokens stay valid until they expire and cannot be
revoked; the only way to invalidate them is to change JWT_SECRET, which signs out every
user on the instance.
Barcode scanning stops working in the web app. Browsers only allow camera access on a secure page, so on plain HTTP the scanner can't open. This is a browser rule, not a Lyftr setting — no configuration turns it back on. The Android app is unaffected: it uses the phone's camera directly.
Use it to get running, then move to HTTPS. If you own a domain, the DNS-01 route above gets you a real certificate on a LAN-only hostname with no ports open — that is the fix, not a workaround. The app shows an amber Not encrypted marker while plain HTTP is in effect. :::
Point Lyftr at your public origin
After the proxy is up, set CORS_ORIGIN to your HTTPS URL so browser and mobile clients are
allowed, and restart:
# in .env
CORS_ORIGIN=https://lyftr.example.com
docker compose up -d
See Configuration for the full list of variables, and the Mobile App page for pointing the phone app at your new HTTPS server.