Skip to content


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.


sb install sandbox-firefox


Downloads Save Location



Visit https://firefox._yourdomain.com_.


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@ -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.



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.


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