Home Assistant Add-on: Firefox Proxy

This Home Assistant add-on enables you to utilize the Firefox web interface within the Home Assistant UI.

Pre-Installation

---

Before proceeding, you need to launch a Firefox Docker container.

NOTE: The Firefox Docker container must share its network namespace with the Home Assistant network.
Below is an example Docker command to run the container in hassio networking mode:

docker run -d \
    --name=firefox \
    --net=hassio \
    -p 5800:5800 \
    -v /docker/appdata/firefox:/config:rw \
    -v /usr/share/fonts:/usr/share/fonts:rw \
    -e DARK_MODE=1 \
    -e DISPLAY_HEIGHT=900 \
    -e DISPLAY_WIDTH=1600 \
    --shm-size 2g \
    jlesage/firefox

Alternatively, you can use the following docker-compose.yml file with Docker Compose.

version: '3'
services:
  firefox:
    image: jlesage/firefox
    ports:
      - "5800:5800"
    networks:
      - hassio
    volumes:
      - "/docker/appdata/firefox:/config:rw"
      - "/usr/share/fonts:/usr/share/fonts:rw"
    environment:
      - DARK_MODE=1
      - DISPLAY_HEIGHT=900
      - DISPLAY_WIDTH=1600

Configuration

---

Parameter	Description
Server Container Name	The name of the Firefox Docker container.
Server Port	The port to access the application's GUI via the web interface.
Secure connection	When enabled, the application's GUI is accessed over an HTTPS connection.