Run Upliftr locally

Two commands and you're running Upliftr at https://upliftr.test — real HTTPS, green padlock, no warnings.

1. Install

curl -fsSL https://get.upliftr.io | bash

It pulls the prebuilt images (no build), generates an admin, and starts everything behind a local HTTPS proxy. It asks for sudo to (a) map upliftr.test to your machine and (b) trust the local certificate authority so the cert is valid in your browser.

2. Open it

https://upliftr.test

Log in with the admin email + password the installer printed (also saved in ~/upliftr/.env). Add your Anthropic key in Settings → AI, and you're ready.

That's it.

Why a local CA?

upliftr.test isn't a public domain, so it can't get a normal (Let's Encrypt) certificate. Instead the installer runs a local certificate authority and trusts it on your machine — that's what makes https://upliftr.test green. Chrome, Safari, and Edge are covered automatically; Firefox keeps its own trust store, so it may need the CA added once (the installer attempts it if certutil is present).

---

Managing it

From ~/upliftr:

docker compose logs -f api          # logs
docker compose pull && docker compose up -d   # update
docker compose down                 # stop

Testing an app running on your own machine

One thing to know: Upliftr's test browser runs inside Docker, so when you give it a URL, localhost means the container, not your laptop. To test an app you're running locally on, say, port 8500, use host.docker.internal in place of localhost:

http://host.docker.internal:8500

Everything else (a staging URL, a public site) you just paste as-is.

Requirements

• Docker Desktop (macOS/Windows) or Docker Engine + Compose v2 (Linux), running.
• Works on Intel and Apple Silicon.

Deploying on a server instead?

Pass a real domain and point its DNS at the host — the installer uses it instead of upliftr.test:

UPLIFTR_DOMAIN=upliftr.acme.com curl -fsSL https://get.upliftr.io | bash

For a full production setup (TLS, backups, teams), see Self-hosting.