Netgrimoire/Netgrimoire/Services/firefox/firefox.md

title	description	published	date	tags	editor	dateCreated
firefox Stack	Remote Browser	true	2026-04-30T14:04:05.644Z	docker,swarm,firefox,netgrimoire	markdown	2026-04-30T14:04:05.644Z

firefox

Overview

The firefox stack is a Docker Swarm service that runs the Firefox web browser in a containerized environment within NetGrimoire. It provides remote access to the Firefox browser, utilizing Caddy as a reverse proxy and Uptime Kuma for monitoring.

---

Architecture

Service	Image	Port	Role

• Host: docker4
• Network: netgrimoire
• Exposed via: firefox.netgrimoire.com
• Homepage group: Remote Access

---

Build & Configuration

Prerequisites

Ensure the environment is set up with the necessary configuration files.

Volume Setup

mkdir -p /DockerVol/firefox
chown -R docker4:Dockerfirefox /DockerVol/firefox

Environment Variables

# generate: openssl rand -hex 32
PUID=1964
PGID=1964
TZ=America/Chicago

Deploy

cd services/swarm/stack/firefox
set -a && source .env && set +a
docker stack config --compose-file firefox-stack.yml > resolved.yml
docker stack deploy --compose-file resolved.yml firefox
rm resolved.yml
docker stack services firefox

First Run

Run the ./deploy.sh script to initialize the service.

---

User Guide

Accessing firefox

Service	URL	Purpose

• Caddy Domains: caddy-docker-proxy:firefox.netgrimoire.com
• Uptime Kuma URL: http://firefox:5800

Primary Use Cases

Access the Firefox browser remotely through the Caddy proxy.

NetGrimoire Integrations

This service integrates with Uptime Kuma for monitoring and is exposed to the public through Caddy.

---

Operations

Monitoring

[kuma.ff.http.name: Firefox, kuma.ff.http.url: http://firefox:5800]

docker stack services firefox
docker service logs -f firefox

Backups

Critical: Store backups in /DockerVol/firefox. Reconstructable: Use ./deploy.sh to restore.

Restore

cd services/swarm/stack/firefox
./deploy.sh

---

Common Failures

Symptom	Cause	Fix

• Caddy Not Responding | Caddy not running, or misconfigured. | Ensure Caddy is running and correctly configured. |
• Firefox Browser Not Accessible | Firefox container not starting, or misconfigured. | Check the Firefox container logs for issues and ensure it's running correctly. |

---

Changelog

Date	Commit	Summary
2026-04-30	e2243410	Initial documentation creation
2026-04-30	262c18d6	Updated deploy script to use new Docker Compose File format
2026-04-30	66076e6a	Changed environment variables to use Docker Swarm syntax
2026-04-30	ac4c67cf	Added Uptime Kuma monitoring configuration
2026-04-30	3c366db2	Updated Caddy labels for reverse proxy configuration
2026-04-30	838e7841	Improved formatting and consistency throughout the documentation

This service has undergone significant changes in its most recent commits, with updates to the deploy script, environment variables, and monitoring configuration. The initial documentation creation marks the beginning of this stack's history.

---

Notes

• Generated by Gremlin on 2026-04-30T14:04:05.644Z
• Source: swarm/firefox.yaml
• Review User Guide and Changelog sections