How do I enable HTTPS for docker-firefox?

Set the SECURE_CONNECTION environment variable to 1 and provide custom certificate files in /config/certs, or let the container generate self-signed ones. Detailed steps are in the Security section of the README, including certificate requirements and monitoring.

docker-firefox vs Selenium for browser testing, which is better?

Docker-firefox provides a full graphical Firefox instance for manual or interactive testing via web/VNC, ideal for remote access or isolated environments. Selenium is better for automated, headless browser testing at scale, as it's designed for scripting and integration with testing frameworks.

Why does my docker-firefox container keep crashing?

This is often due to the membarrier system call being blocked in older Docker versions. Check the 'Allowing the membarrier System Call' section for fixes, such as using a custom seccomp profile or updating Docker to allow this call for stable operation.

Can I use GPU acceleration with docker-firefox?

Yes, but only with open-source kernel drivers like amdgpu or i915 by exposing /dev/dri to the container. Proprietary drivers like NVIDIA's are not supported, as noted in the GPU Acceleration Support section, which may limit performance on some systems.

How to update the Firefox version in docker-firefox?

Pull the latest Docker image with 'docker pull jlesage/firefox' and recreate the container, as updates are bundled with image releases. The README details this in the Docker Image Update section, including methods for Synology and unRAID.

Is docker-firefox secure for exposing on the internet?

With HTTPS enabled, web authentication, and VNC encryption, it can be secure, but always use strong passwords, custom certificates, and restrict access via environment variables like WEB_LOCALHOST_ONLY to mitigate risks, as advised in the Security section.

Open-Awesome

docker-firefox

MITShellv26.03.1

A Docker container for Firefox that provides a full graphical browser interface accessible via web or VNC.

GitHub

2.5k stars425 forks0 contributors

What is docker-firefox?

jlesage/docker-firefox is a Docker container that packages Mozilla Firefox for isolated, remote execution. It provides a full graphical browser interface accessible via a web browser or VNC client, enabling users to run Firefox without installing it locally on their machines. The container includes additional features like audio streaming, clipboard sharing, a file manager, and a terminal for enhanced remote usability.

Target Audience

System administrators, developers, and users who need to run Firefox in a containerized environment for testing, remote access, or isolated browsing. It's particularly useful for those managing Docker-based infrastructure or requiring browser access from restricted or headless systems.

Value Proposition

Developers choose this container for its ease of deployment, security features, and comprehensive remote access capabilities. It offers a production-ready, configurable solution with persistent storage and extensive customization options, making it a reliable alternative to manual Firefox installations in containerized workflows.

Overview

Docker container for Firefox

Use Cases

Best For

Running Firefox in isolated Docker environments for testing web applications
Providing remote browser access via web interface for users without local installations
Setting up a secure, containerized browsing session with encrypted VNC or HTTPS
Deploying Firefox on headless servers with graphical access through VNC
Creating disposable browser instances for security-sensitive tasks
Integrating Firefox into Docker Compose stacks for development or demo environments

Not Ideal For

Projects requiring native Firefox performance with full hardware acceleration and direct system integration
Teams that rely heavily on VNC access but need advanced features like automatic clipboard synchronization or web notifications
Environments with strict security policies that require VNC passwords longer than 8 characters
Systems running older Docker versions without easy fixes for the membarrier system call, leading to frequent crashes

Pros & Cons

Pros

Web-Based Accessibility

Allows full Firefox GUI access from any modern browser without client installations, as shown in the Quick Start section with HTTP on port 5800.

Integrated Remote Tools

Includes a web file manager, terminal, audio streaming, and clipboard sync, enhancing remote usability as detailed in sections like Web Audio and Web File Manager.

Extensive Security Configurations

Supports HTTPS, VNC encryption, and web authentication, with options for custom certificates and user management, as covered in the Security and Web Authentication sections.

High Customizability

Configurable via environment variables for display settings, Firefox preferences, and features like dark mode, detailed in the Environment Variables table.

Persistent and Isolated Storage

All application data is saved in a persistent /config volume, ensuring state is maintained across container recreations, as mentioned in Data Volumes.

Cons

VNC Feature Limitations

Key features like automatic clipboard sync, web notifications, and the web terminal are not available when using VNC clients, limiting functionality for remote desktop-style access.

VNC Password Security Limitation

VNC passwords are restricted to 8 characters due to protocol constraints, which may not meet modern security standards for sensitive deployments.

Complex Security Setup

Enabling secure connections requires managing certificates and additional configuration, which can be cumbersome for users unfamiliar with SSL/TLS setup.

Dependency on Docker Configuration

Proper operation depends on allowing the membarrier system call, which may require manual intervention in older Docker versions, as noted in the troubleshooting section.

Frequently Asked Questions

Related Projects

ansible

Ansible is a radically simple IT automation platform that makes your applications and systems easier to deploy and maintain. Automate everything from code deployment to network configuration to cloud management, in a language that approaches plain English, using SSH, with no agents to install on remote systems. https://docs.ansible.com.

Stars68,816

Forks24,141

Last commit3 days ago

localstack

💻 A fully functional local AWS cloud stack. Develop and test your cloud & Serverless apps offline

Stars65,026

Forks4,730

Last commit2 months ago

traefik

The Cloud Native Application Proxy

Stars63,596

Forks6,040