zf-bridge-unraid
Docker app from Selfhosters
ZoneFoundry Bridge — connects your Sonos system to ZoneFoundry's iOS app, voice assistant, and IM bots (Telegram, WeChat, QQ) via the cloud relay.
Overview
Categories
Download Statistics
Related apps
Explore more like this
Explore allLinks
Details
zonefoundry/bridge:latestRuntime arguments
- Network
host- Shell
sh- Privileged
- false
- Extra Params
--cap-drop ALL --read-only --tmpfs /tmp:rw,nosuid,nodev,size=16m --group-add 281
Template configuration
ZoneFoundry cloud relay WebSocket URL.
- Target
- ZF_RELAY_URL
- Default
- wss://relay.zonefoundry.dev/ws
- Value
- wss://relay.zonefoundry.dev/ws
One-time 6-letter code from your iOS app's Add Bridge screen. Only needed for first launch — once paired, container caches credentials in /app/data and you can clear this field.
- Target
- ZF_PAIR_CODE
Advanced: explicit user_id from existing pairing (skips pair-code redeem). Leave empty to use pair code instead.
- Target
- ZF_USER_ID
Advanced: explicit secret matching User ID. Leave empty to use pair code instead.
- Target
- ZF_AGENT_SECRET
Advanced: explicit connector identity for multi-bridge users. Leave empty for default-legacy.
- Target
- ZF_CONNECTOR_ID
Persistent data: cached pairing credentials. Must be chowned 10001:10001 on host (chown -R 10001:10001 /mnt/user/appdata/zonefoundry-bridge).
- Target
- /app/data
- Default
- /mnt/user/appdata/zonefoundry-bridge
- Value
- /mnt/user/appdata/zonefoundry-bridge
Mounts the host's docker socket so the bridge can pull and apply its own image updates when you tap '升级' / 'Apply Update' in the iOS app's Bridges screen. Combined with --group-add 281 in Extra Parameters, the non-root bridge user gets permission to talk to Docker. Remove this mount and the --group-add flag if you prefer to update manually via Apply Update on this template.
- Target
- /var/run/docker.sock
- Default
- /var/run/docker.sock
- Value
- /var/run/docker.sock