tibynx/firefox repository overview

⁠🦊 Firefox⁠

This container allows you to use the Firefox⁠ web browser trough another web browser using KasmVNC. Firefox is a free web browser backed by Mozilla, a non-profit dedicated to internet health and privacy.

⁠Setup

To set up the container, you can use docker-compose or the docker cli. Unless a parameter is flagged as 'optional', it is mandatory and a value must be provided. This container is using a linuxserver.io base, so you can use their mods⁠ and configurations to enable additional functionality within the container.

⁠docker-compose⁠ (recommended)

---
services:
  firefox:
    image: tibynx/firefox:latest
    container_name: firefox-browser
    security_opt:
      - seccomp:unconfined #optional
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=Etc/UTC
      - FIREFOX_CLI=https://www.github.com/ #optional
    volumes:
      - /path/to/config:/config
    ports:
      - 3000:3000
      - 3001:3001
    shm_size: "1gb"
    restart: unless-stopped

⁠docker-cli⁠

docker run -d \
  --name=firefox-browser \
  --security-opt seccomp=unconfined `#optional` \
  -e PUID=1000 \
  -e PGID=1000 \
  -e TZ=Etc/UTC \
  -e FIREFOX_CLI=https://www.github.com/ `#optional` \
  -p 3000:3000 \
  -p 3001:3001 \
  -v /path/to/config:/config \
  --shm-size="1gb" \
  --restart unless-stopped \
  tibynx/firefox:latest

⁠Security

By default, this container has no authentication. Configure the optional environment variables CUSTOM_USER and PASSWORD to enable basic HTTP auth. This should only be used to locally secure the container on a local network. If you're exposing this container to the internet, it's recommended to use a reverse proxy or a VPN such as SWAG⁠ or Tailscale.

⁠Config

Containers are configured using parameters passed at runtime (such as those above). These parameters are separated by a colon and indicate <external>:<internal> respectively. For example, -p 8080:80 would expose port 80 from inside the container to be accessible from the host's IP on port 8080 outside the container. Further options can be found on the KasmVNC Base Images⁠ repo.

⁠Updating

This image is updated monthly. To update the app, you'll need to pull the latest image and redeploy the container with your configuration. It's not recommended to update the app inside the container. Updating this way could cause issues with configurations and mods.

⁠Usage

To access the container, navigate to the ip address for your machine with the port you provided at the setup.

• http://yourhost:3000/⁠
• https://yourhost:3001/⁠