From 2dec2d7d257fb25319df63fcec75914f56ac39f0 Mon Sep 17 00:00:00 2001
From: danroozemond <d.roozemond@tibo.energy>
Date: Fri, 10 Apr 2026 14:58:18 +0200
Subject: [PATCH] feat: add docker-compose example for remote (ui.com cloud)
 mode

Adds docker-compose-remote.yml and matching env example for running
unifi-poller against the UniFi cloud API instead of a local controller.
Uses UP_UNIFI_REMOTE and UP_UNIFI_REMOTE_API_KEY for auto-discovery of
all Network-capable consoles via api.ui.com.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
---
 init/docker/docker-compose-remote.env.example | 16 ++++++
 init/docker/docker-compose-remote.yml         | 51 +++++++++++++++++++
 2 files changed, 67 insertions(+)
 create mode 100644 init/docker/docker-compose-remote.env.example
 create mode 100644 init/docker/docker-compose-remote.yml

diff --git a/init/docker/docker-compose-remote.env.example b/init/docker/docker-compose-remote.env.example
new file mode 100644
index 00000000..11993f46
--- /dev/null
+++ b/init/docker/docker-compose-remote.env.example
@@ -0,0 +1,16 @@
+# influxdb
+INFLUXDB_HTTP_AUTH_ENABLED=true
+INFLUXDB_ADMIN_USER=unpoller
+INFLUXDB_ADMIN_PASSWORD=CHANGEME
+INFLUXDB_DB=unpoller
+
+# grafana
+GRAFANA_USERNAME=admin
+GRAFANA_PASSWORD=grafanaadmin
+
+# unifi-poller
+POLLER_TAG=latest
+POLLER_DEBUG=false
+POLLER_SAVE_DPI=false
+# API key from https://api.unifi.ui.com — generate one under "API Keys" in the UI Site Manager
+UNIFI_API_KEY=your_api_key_here
diff --git a/init/docker/docker-compose-remote.yml b/init/docker/docker-compose-remote.yml
new file mode 100644
index 00000000..3b7429d2
--- /dev/null
+++ b/init/docker/docker-compose-remote.yml
@@ -0,0 +1,51 @@
+# UniFi Poller with InfluxDB + Grafana using remote (ui.com cloud) mode.
+# Requires an API key from https://api.unifi.ui.com — no controller user/pass needed.
+version: '3'
+services:
+  influxdb:
+    restart: always
+    image: influxdb:1.8
+    ports:
+      - '8086:8086'
+    volumes:
+      - influxdb-storage:/var/lib/influxdb
+    environment:
+      - INFLUXDB_DB=${INFLUXDB_DB}
+      - INFLUXDB_HTTP_AUTH_ENABLED=${INFLUXDB_HTTP_AUTH_ENABLED}
+      - DOCKER_INFLUXDB_INIT_MODE=setup
+      - DOCKER_INFLUXDB_INIT_USERNAME=${INFLUXDB_ADMIN_USER}
+      - DOCKER_INFLUXDB_INIT_PASSWORD=${INFLUXDB_ADMIN_PASSWORD}
+  grafana:
+    image: grafana/grafana:latest
+    restart: always
+    ports:
+      - '3000:3000'
+    volumes:
+      - grafana-storage:/var/lib/grafana
+    depends_on:
+      - influxdb
+    environment:
+      - GF_SECURITY_ADMIN_USER=${GRAFANA_USERNAME}
+      - GF_SECURITY_ADMIN_PASSWORD=${GRAFANA_PASSWORD}
+      - GF_INSTALL_PLUGINS=grafana-clock-panel,natel-discrete-panel,grafana-piechart-panel
+  unifi-poller:
+    restart: always
+    image: ghcr.io/unpoller/unpoller:${POLLER_TAG}
+    depends_on:
+      - grafana
+      - influxdb
+    environment:
+      - UP_INFLUXDB_DB=${INFLUXDB_DB}
+      - UP_INFLUXDB_USER=${INFLUXDB_ADMIN_USER}
+      - UP_INFLUXDB_PASS=${INFLUXDB_ADMIN_PASSWORD}
+      - UP_INFLUXDB_URL=http://influxdb:8086
+      # Remote (cloud) mode: connects via api.ui.com, no controller URL or user/pass required.
+      # UP_UNIFI_REMOTE enables auto-discovery of all Network-capable consoles on your account.
+      - UP_UNIFI_REMOTE=true
+      - UP_UNIFI_REMOTE_API_KEY=${UNIFI_API_KEY}
+      - UP_POLLER_DEBUG=${POLLER_DEBUG}
+      - UP_UNIFI_DEFAULT_SAVE_DPI=${POLLER_SAVE_DPI}
+      - UP_PROMETHEUS_NAMESPACE=unpoller
+volumes:
+  influxdb-storage:
+  grafana-storage: