Skip to content

Firefox

What is it?

Mozilla Firefox is a free and open-source web browser developed by Mozilla Foundation and its subsidiary, Mozilla Corporation.

The GUI of the application is accessed through a modern web browser (no installation or configuration needed on the client side) or via any VNC client.

Deployment

sb install sandbox-firefox

Usage

Downloads Save Location

/mnt/unionfs/downloads/firefox

Web

Visit https://firefox._yourdomain.com_.

VNC

The role supports VNC access over an SSH tunnel (local port forwarding) to Saltbox.

Example Command on Local Machine Some VNC apps have this functionality built-in!

ssh -L localhost:5900:firefox:5900 seed@203.0.113.1 -p 8843 # (1)!
  1. -L localhost:5900:firefox:5900: This part specifies local port forwarding. It tells SSH to listen on port 5900 on your local machine and forward any traffic to the firefox Docker container on port 5900 on the Saltbox host. In other words, it sets up a tunnel between your local port 5900 and the container's port 5900.
    Complete the command with your usual SSH info: USERNAME@SALTBOX_EXTERNAL_IP -p SSH_PORT.

While the tunnel is active, you can use a VNC client to access the GUI via the address localhost:5900.

Configuration

Security

By default, web access is restricted by Authelia, and VNC access is secured through SSH authentication; hence, no VNC password is configured. If you wish to add this extra layer of security, the process is straightforward:

  1. Run the following command:

    $EDITOR /opt/firefox/.vncpass_clear
    

  2. Enter your desired password (up to 8 characters in length) and save the file.

  3. Restart the container.

Misc

Various properties can be customized in /opt/firefox/.env. To apply changes to this file, redeploy the container.