Skip to main content

Get started

Zoop collects recordings from your WHOOP and keeps them on your server. Your iPhone and web dashboard show the same sleep, recovery, activity and weight history.

Before you start​

You’ll need:

  • A WHOOP 5.0 or MG and an iPhone running iOS 17 or later.
  • A server with Docker Engine, Compose v2 and Git.
  • A Mac with Xcode and an Apple development team that supports HealthKit signing.

The iPhone app is not on the App Store yet. Server images build from source; Linux amd64 is tested, while arm64 validation is pending.

1. Start your server​

git clone https://github.com/MakisChristou/zoop.git
cd zoop
./tools/setup.sh
docker compose up -d --build --wait
./tools/setup.sh --show-code

The first build compiles the API and dashboard. Wait for Compose to report them healthy.

Open http://localhost:8080, enter the setup code and create your admin account. Keep the generated .env file private. Once an account exists, setup closes.

2. Make it reachable from your phone​

The default address works only on the server itself. For a trusted home network, set these values in .env, using your server’s actual LAN address:

ZOOP_ORIGIN=http://192.168.1.20:8080
ZOOP_BIND=192.168.1.20

Then apply the change:

docker compose up -d --wait

Open that address in Safari on your iPhone to check the connection. HTTP sends passwords and health data unencrypted: use a trusted LAN or VPN, or configure your own HTTPS proxy. See network options.

3. Connect your band​

Build and install the iPhone app, then sign in with your server address and account. Assign your band’s serial to the account during server setup or with the device ownership command.

Pair the band in the official WHOOP app first. Quit that app before connecting with Zoop, and keep the existing Bluetooth bond.

4. Check your first recordings​

Leave Zoop connected to your band while it syncs. Open the web dashboard with the same account to see the uploaded data. Some measurements need a full night or several nights of history; an empty Recovery ring is expected at first.

Understand your measurements, then set up your first backup. If something is missing, start with troubleshooting.