| separates cameras (K1, K2, ...)
, separates hosts inside one camera (their counts are summed into that Kn)
No | keeps legacy behavior: each comma-separated host is its own Kn
One multi-host camera only: use a trailing | (e.g. http://a,http://b,http://c|)

Tuang uses each host's total_count as K{n} - Use; masuk keeps K{n} - In and K{n} - Out.

Install path

Deploy code to /opt/karung-web-admin (matches the systemd units below).

Configure source hosts (required)

cd /opt/karung-web-admin
cp sources.env.example sources.env
nano sources.env   # set real KTC/KPC URLs for this site

Example sources.env:

# K1 = three hosts summed; K2 = one host
KTC_BASE_URL=http://10.0.0.11:9000,http://10.0.0.12:9000,http://10.0.0.13:9000|http://10.0.0.14:9000
# Same grouping for masuk (In/Out summed per Kn)
KPC_BASE_URL=http://10.0.0.11:7000,http://10.0.0.12:7000,http://10.0.0.13:7000|http://10.0.0.14:7000
SOURCE_HISTORY_DAYS=30
SOURCE_PULL_INTERVAL_SECONDS=30

Legacy (unchanged): http://a:9000,http://b:9000 still means K1 and K2 (same for KPC).

After editing:

sudo systemctl restart karung-web-admin-pull-sources.service

sources.env is gitignored so each production host keeps its own IPs.

Puller (systemd service)

sudo cp karung-web-admin-pull-sources.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now karung-web-admin-pull-sources.service

It loads /opt/karung-web-admin/sources.env, runs pull_sources.py --loop, and refreshes every SOURCE_PULL_INTERVAL_SECONDS (default 30).

Writes:

Live JSON: karung_tuang.json, karung_masuk.json
History SQLite: karung_tuang.db, karung_masuk.db
Status: .pull_status.json

One-shot (optional / debugging):

python pull_sources.py

Web app

python app.py

Or enable the dashboard service:

sudo cp karung-web-admin.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now karung-web-admin.service

If you previously used frigate-counter_karung-web-admin.service, disable/remove it:

sudo systemctl disable --now frigate-counter_karung-web-admin.service
sudo rm /etc/systemd/system/frigate-counter_karung-web-admin.service
sudo systemctl daemon-reload

Dashboard: http://0.0.0.0:8090/
Combined API: GET /api/combined?history_days=30

Environment

Configured in sources.env (see sources.env.example):

Variable	Description
`KTC_BASE_URL`	Tuang/KTC source groups (`\|` = cameras, `,` = hosts in a camera)
`KPC_BASE_URL`	Masuk/KPC source groups (same grouping syntax)
`SOURCE_HISTORY_DAYS`	History window to pull (default `30`)
`SOURCE_PULL_INTERVAL_SECONDS`	Pull loop interval (default `30`)
`KARUNG_TUANG_JSON`	Live tuang JSON path (default `karung_tuang.json`)
`KARUNG_MASUK_JSON`	Live masuk JSON path (default `karung_masuk.json`)
`KARUNG_TUANG_DB`	Tuang history DB path (default `karung_tuang.db`)
`KARUNG_MASUK_DB`	Masuk history DB path (default `karung_masuk.db`)