VP ViewPane
Features Stack Pricing Docs Report a bug Get notified
Documentation

Docs

Self-hosted Frigate companion app · setup, configuration, troubleshooting

v1 launch — full content lands before public release

Hit a bug? Tell us. Structured form with the fields we need to reproduce — app version, OS, device, Frigate version, steps, and an attachment slot for logs or a screenshot.
Report a bug

On this page

  1. Quick start
  2. Frigate config requirements
  3. Push relay setup
  4. Tailscale walkthrough
  5. MQTT auth
  6. FAQ
  7. Troubleshooting

These docs assume you already run Frigate NVR — the community build or Frigate+ NVR commercial — and want a phone-shaped window into it. If you don't have Frigate yet, start at the Frigate project's official documentation, get a single camera working in the web UI, then come back here.

01Quick start

Content coming for v1

Install the app from your store, point it at your Frigate server URL, and pick a camera. The first stream is on screen in under two minutes if your network is healthy.

02Frigate config requirements

Content coming for v1

Recommended Frigate version, the restream block ViewPane likes, snapshot/recording flags, frigate-auth coexistence, and the Frigate+ NVR commercial-build differences.

03Push relay setup

Content coming for v1

Drop-in docker-compose template for the self-hosted push relay (mosquitto + relay container), MQTT topic conventions ViewPane subscribes to, and the per-device REGISTER_SECRET handshake.

04Tailscale walkthrough

Content coming for v1

How ViewPane locates your Frigate server over Tailscale without port-forwarding, ACL recommendations, and the MagicDNS pattern that just works.

05MQTT auth

Content coming for v1

Generating broker passwords that survive Frigate restarts, locking the broker to localhost + Tailscale, ACLs for the relay user vs the Frigate user, and the bridge-config gotchas you do NOT want to discover at 1 a.m.

06FAQ

Content coming for v1

Why no live RTSP toggle on Free? Why does my 4K HEVC stream stutter? Does ViewPane work with Reolink? Will it work without Tailscale? When does Pro renew?

07Troubleshooting

Content coming for v1

The port 8080 vs 5000 confusion, MQTT lockdown bugs, Reolink port-block weirdness, the iGPU-not-exposed kernel issue on N100 mini PCs, and the install-playbook landmines we already mapped.

Have a setup question we should answer here?
Email ken@campbellsoftstudios.com — real questions become real FAQ entries.
Docs Features Pricing Privacy Terms Report a bug GitHub
© 2026 CampbellSoft Studios · Made for the Frigate community.