frigate/web/README.md

This is the Frigate frontend which connects to and provides a User Interface to the Python backend.

Web Development

Installing Web Dependencies Via NPM

Within /web, run:

npm install

Running development frontend

Within /web, run:

npm run dev

By default, this will connect to localhost:5000 using HTTP protocol. You can customize the connection with these environment variables:

# Basic configuration - point to your Frigate instance
PROXY_HOST=<ip_address:port> npm run dev

# Advanced configurations
# Use HTTPS instead of HTTP (websocket will use WSS instead of WS)
PROXY_PROTOCOL=https PROXY_HOST=<ip_address:port> npm run dev

# Disable certificate validation for self-signed or invalid certs
PROXY_SECURE=false PROXY_PROTOCOL=https PROXY_HOST=<ip_address:port> npm run dev

Proxy Configuration Notes

• PROXY_HOST: Sets the host and port for your Frigate instance (default: localhost:5000)
• PROXY_PROTOCOL: Sets the protocol to use (http or https, default: http)
• PROXY_SECURE: Controls certificate validation. Set to false when:
  • Using self-signed certificates
  • Working with invalid or expired certificates
  • Connecting to HTTPS services in development environments

These options are particularly useful when working with Frigate instances that use HTTPS but don't have proper certificate validation.

Extensions

Install these IDE extensions for an improved development experience:

• eslint