blob-firebox is a Dockerized headless Firefox environment with a lightweight window manager and VNC access. It's designed to be running firefox inside a container while keeping state, download/files, and secrets mounted as external volumes.
I needed a remote browser I could trust, isolate, restart, and access from low-power machines, so I built one that does exactly that.
- Runs Firefox in a headless X11 session (via
Xvfb). - Managed by bspwm (minimal window manager).
- Exposes a VNC server for remote access.
- Uses persistent volumes for:
- Firefox profile
- Downloads / user files
- VNC password / secrets
- Auto-deploy scripts for server environments (optional).
git clone https://github.com/mrmodori/blob-firebox.git
cd blob-fireboxmkdir -p profile outbox secretx11vnc -storepasswd mypassword ./secret/vnc.passdocker compose up --build -d- Open a VNC client (e.g.
tigervnc-viewer,Remmina). - Connect to:
localhost:5900 - Use the password you set in step 3.
- Open
http://localhost:6080/vnc.htmlin webbrowser.
| Volume | Path inside container | Purpose |
|---|---|---|
| profile | /home/firefox/.mozilla |
Persistent Firefox profile (bookmarks, addons, settings) |
| outbox | /home/firefox/outbox |
Downloads and user directories (downloads, uploads, files) |
| secret | /home/firefox/secret |
VNC password file (vnc.pass) |
-
This image uses Arch Linux (rolling release) as its base. Builds may occasionally break due to upstream package changes. For long-term stability, you may want to pin a snapshot or adapt the Dockerfile.
-
By default, the VNC port is bound only to localhost (127.0.0.1) for safety. If you need remote access, use an SSH tunnel or adjust the port mapping in
docker-compose.yml.
For advanced users:
Blob Firebox also includes scripts (post-receive, auto-deploy.sh) for Git-based auto deployment on a server.
See documentation/auto-deploy-README.md (to be added) for details.
See documentation/TODO.md for planned improvements.
This project is licensed under the BSD 3-Clause License.
See the LICENSE file for details.
For AI-related usage, see the AI_POLICY.md.
blob-firebox is an open-source project released under the BSD 3-Clause License. If you're interested in commercial use, licensing, or collaboration, feel free to reach out.
These terms restate and emphasize how the BSD 3-Clause License applies to AI/ML uses. Training, fine-tuning, or embedding of this project into AI/ML systems is permitted as long as the BSD 3-Clause License and attribution are preserved.
These clarifications do not remove or restrict any rights already granted by the BSD 3-Clause License. For all non-AI uses, the BSD 3-Clause License alone governs.
Project initialized and maintained by Blob (aka mrmodori).