BaiFi Central

One binary for every board at every site. The WiFi name, the WiFi password and the controller address are typed into the board itself from a phone, and the board asks the controller for its own secret — so there is nothing to edit before flashing and no per-board build.

Works on NodeMCU v3 and Wemos D1 mini. Includes the thermal printer and push-button kiosk mode.

How to flash it

1. Flash baifi-coin.bin at offset 0x00000 (esptool, NodeMCU Flasher, or coin-bridge/flash.sh). Erase the flash first — a board that keeps an old secret talks to a controller that no longer knows it.
2. On your phone, join the network the board raises: BaiFi-Setup-XXXX — no password. Any page you open lands on the setup form.
3. Pick the shop's WiFi. The password box appears only if that network has one, and the controller is found on the network by itself — there is nothing else to fill in.
4. Approve the board in the dashboard under Vendo List. It picks up its secret within five seconds and the coin slot opens.

Download firmware

Moves a KiTifi WiFi coin slot to BaiFi without visiting it. The controller sends it to the board the way KiTifi's own Update button does; the board keeps its WiFi, finds the controller and installs the coin firmware above, then waits in the Vendo List to be activated.

You do not normally download this: the controller fetches it itself from Vendo List → KiTifi vendos. WiFi boards only — a LAN board cannot be moved this way.

How to move a site from KiTifi

1. Note each vendo's pins from KiTifi's Settings; they are set again in BaiFi.
2. Give the BaiFi controller the KiTifi server's address (10.0.0.1). The KiTifi vendos report to it and appear under Vendo List → KiTifi vendos.
3. Press Migrate on one vendo near you first, then Migrate all WiFi vendos.
4. Activate each one in the Request Vendo List as it arrives, and set its pins.

Download migrator

The whole controller on one disk image: the portal, RADIUS, billing, vouchers, payments and the cloud link. Write it to the mini PC's disk and it comes up configured — there is no installer to sit through.

First boot generates this machine's own keys and shows its address on the console. Default console login baifi / baifi — the first login makes you choose a new password before anything else. It runs as a 2-day free trial; enter a licence key in the dashboard to keep using it after that.

How to write it

1. Decompress and write to the target disk — balenaEtcher, Rufus, or xzcat baifi-os-*.img.xz | dd of=/dev/sdX bs=4M status=progress.
2. Boot the mini PC. It grows its own filesystem and starts.
3. Read the address off the boot screen and open http://<address>:8080/admin.
4. Add the MikroTik under Network → Routers and press Provision. It configures the router, RADIUS, CoA and the captive portal itself.

Download image

The captive portal, served by the router itself. Provisioning pushes these automatically; this copy is for uploading by hand, or for a router being set up before its controller is on site.

Every page is local and every link is relative — a captive portal browser will load what the hotspot hands it and will not follow a redirect anywhere else.

How to install it by hand

1. Unzip. Delete any existing baifi-hotspot folder in Winbox → Files first, or MikroTik adds login_1.html beside the old one and keeps serving the old one.
2. Drag the baifi-hotspot folder into Files.
3. /ip hotspot profile set <profile> html-directory=baifi-hotspot

Download portal files