FKMTime Instance Manager

Manages FKMTime instances running on OpenWRT routers (or any Linux host with Docker).

Running natively

python3 manager.py

Serves on http://0.0.0.0:8181. On OpenWrt, sign in with any LuCI username/password (same as the web UI, via rpcd). Elsewhere the default is root / root in auth.json.

macOS

On macOS it is recommended to run the manager natively (not in Docker). Running natively gives Docker containers access to the host's Bluetooth and mDNS stack via mdns-docker-adapter.

Once the manager is running, open the Adapter tab in the web UI to download and enable docker-adapter with one click.

Wi-Fi stats on OpenWrt

On OpenWrt, while an instance is running, the manager records the hotspot's per-station Wi-Fi stats (iw station dump, the in-use channel's survey, DHCP leases, load) once a minute. They are written every 10 minutes, and on stop, to <instance>/logs/wifi-YYYY-MM-DD_HH.log.gz (UTC hour); read them with zcat. Files older than 30 days are deleted, and the oldest ones while they total more than 200 MB.

Offline web UI

The portal loads only local assets from fim/web/static/ (app.css, app.js, login.css) — no CDN or external CSS/JS packages. Syntax highlighting is built into app.js.

Running in Docker

The manager needs the Docker socket so it can run docker compose commands on the host.

Important: same-path bind mount

The FKMTime instance templates use relative bind mounts (e.g. ./db, ./logs). Docker Compose resolves these to absolute paths and passes them to the host Docker daemon, so the data directory must be mounted at the same absolute path inside and outside the container.

Quick start

export FIM_DATA_DIR=/opt/fim
mkdir -p $FIM_DATA_DIR
docker compose up -d

Override FIM_DATA_DIR in a .env file beside docker-compose.yml if you prefer a different path.

Manual docker run

docker run -d \
  -p 8181:8181 \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /opt/fim:/opt/fim \
  -e FIM_DATA_DIR=/opt/fim \
  fim