Quick Start

ZerryBit is a battery-powered e-ink display. This guide takes it from asleep in the box to showing its first screen.

The early steps are the same for everyone. You wake the device and connect it to Wi-Fi. Right at the end the setup forks: use it with the ZerryBit app (recommended) or run it in Self-Host mode against your own server. The whole thing takes about five minutes.

Watch the full setup, start to finish.

Step 1 — Wake the device

The device ships asleep.

1. Press the Zerry button to begin setup.
2. The welcome screen appears and the device starts looking for Wi-Fi.

Step 2 — Choose your Wi-Fi network

1. The device scans for nearby Wi-Fi networks and lists them.
2. Select your network from the list.

Both the app and Self-Host mode use this network. The device joins it as a normal client. It does not create its own hotspot.

Step 3 — Enter your Wi-Fi password

1. An on-screen keyboard opens.
2. Type your Wi-Fi password using the Zerry button.
3. Press —>.

The device connects to the internet. Once it's online it asks how you want to use it. This is the part where the two setups split.

Choose how you'll use ZerryBit

The device now shows "How will you use ZerryBit?" with two choices:

• Use with the app (recommended) — the standard, cloud-connected experience.
• Self-Host mode (for advanced users) — drive the device from your own HTTP server.

Pick the path that matches you.

Use with the app (recommended)

This is the standard, cloud-connected path — no server and no configuration. You install the app, create an account, and pair the device by scanning a QR code.

1. Download the ZerryBit app. After you choose Use with the app, the device shows a download QR code for each app store on screen — point your phone's camera at the one for your platform, or open the store directly:
   • Android — Google Play
   • iPhone / iPad — App Store
2. Create your account. Open the app and sign up with your email address. We'll email you a confirmation link — click it, then return to the app and sign in.
3. Generate the pairing code. Back on the ZerryBit, press —> to continue. The device displays a unique pairing QR code, with its MAC address and pairing code printed just below it.
4. Pair from the app. Tap the + at the top of the app to open the QR scanner, then scan the code on the device's screen.
   • No camera available? Choose manual entry instead and type the MAC address and pairing code shown beneath the QR code.
5. Set up the device. The app opens a setup screen where you name the device, pick an icon, and choose a refresh interval.
6. Confirm on the device. The app prompts you to press —> on the ZerryBit one last time. Press it — the device starts running and is now connected to the app.

That's it — your ZerryBit is paired and will refresh on the schedule you chose.

Self-Host mode — drive it from your own server

Self-Host mode turns the device into a thin client of an HTTP server you run: it POSTs to your server on every wake, and your server replies with an image to show.

1. Select Self-Host mode (for advanced users). The device asks to confirm — "Are you sure? Self-Host mode requires manual setup" — choose Yes.
2. The device shows a QR code linking to the Self-Host guide. Scan it to open the full reference on your phone, then press Continue.
3. The Self-Host Setup screen appears, showing the device's own IP address and an example of the configuration fields.

Now send your config to the device at POST http://<device-ip>/config from any HTTP client — curl, Postman, a script:

curl -X POST http://<device-ip>/config \
  -H "Content-Type: application/json" \
  -d '{"url":"http://192.168.1.50:8080/screen","sleepSec":900,"sidebar":true}'

When the device accepts it, the screen shows "Configured" and immediately fetches its first image.

From now on the device POSTs to your url on every wake and your server replies with a black-and-white image. That's the whole loop.

• The Self-Host guide has the full field reference (url, sleepSec, sidebar, fullRefreshFrequency, imperialUnitsEnabled, tlsInsecure), the wake-request format, and a complete example server.
• Don't want to write a server? The Home Assistant add-on is a ready-made self-host server with a visual dashboard builder — just point the device's url at it.

Next steps

• Self-Host — the complete protocol: config fields, the wake request, and the image reply format.
• Home Assistant — run ZerryBit Engine as your self-host server and build dashboards from your Home Assistant entities.