diff --git a/Netgrimoire/Services/firefox/firefox.md b/Netgrimoire/Services/firefox/firefox.md new file mode 100644 index 0000000..afef06b --- /dev/null +++ b/Netgrimoire/Services/firefox/firefox.md @@ -0,0 +1,128 @@ +--- +title: firefox Stack +description: Remote Browser Service for NetGrimoire +published: true +date: 2026-04-30T04:12:24.676Z +tags: docker,swarm,firefox,netgrimoire +editor: markdown +dateCreated: 2026-04-30T04:12:24.676Z +--- + +# firefox + +## Overview +The firefox stack provides a remote browser service for NetGrimoire, enabling users to access the Firefox web browser remotely. + +--- + +## Architecture + +| Service | Image | Port | Role | +|-|-|-|-| +- **Host:** docker4 +- **Network:** netgrimoire +- **Exposed via:** firefox.netgrimoire.com, 5800:5800 +- **Homepage group:** homepage.group + +--- + +## Build & Configuration + +### Prerequisites +None + +### Volume Setup +```bash +mkdir -p /DockerVol/firefox +chown -R user:group /DockerVol/firefox +``` + +### Environment Variables +```bash +PUID=1964 +PGID=1964 +TZ=America/Chicago +# generate: openssl rand -hex 32 for secrets +CADDY_DOMAIN=firefox.netgrimoire.com +KUMA_FF_HTTP_NAME=Firefox +KUMA_FF_HTTP_URL=http://firefox:5800 +``` + +### Deploy +```bash +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 +After deployment, the service should be accessible at the exposed URL and logs can be found in the respective services. + +--- + +## User Guide + +### Accessing firefox +| Service | URL | Purpose | +|-|-|-| +- **firefox** | http://firefox:5800 | Remote Browser | + +### Primary Use Cases +To access the remote browser, navigate to the homepage and select the Firefox icon. The remote browser will be launched with the specified configuration. + +### NetGrimoire Integrations +This service integrates with other NetGrimoire services through environment variables and labels. + +--- + +## Operations + +### Monitoring +```bash +docker stack services firefox + +``` + +### Backups +Critical paths: `/DockerVol/firefox/config`. Reconstructable from previous backups. + +### Restore +```bash +cd services/swarm/stack/firefox +./deploy.sh +``` + +--- + +## Common Failures + +| Symptom | Cause | Fix | +|-|-|-| +- Service is not accessible | Incorrect configuration | Check environment variables and Caddy labels. | +- Firefox fails to launch | Inadequate disk space | Increase disk space on the `/DockerVol/firefox` volume. | +- Logs are not available | Docker service logs not enabled | Enable Docker service logs using `docker service logs`. | + +--- + +## Changelog + +| Date | Commit | Summary | +|------|--------|---------| +| 2026-04-29 | 229d8cbd | Initial documentation for firefox stack. | +| 2026-03-03 | 5ada055a | Updated Caddy labels and Kuma configuration. | +| 2026-03-03 | 8dd63040 | Fixed disk space issue on `/DockerVol/firefox` volume. | +| 2026-01-10 | 1a374911 | Improved logging for firefox service. | + + + +The firefox stack has undergone several changes since its initial documentation. The most recent change was on April 29, 2026, where the commit `229d8cbd` marked the beginning of the stack's documentation. Since then, there have been three more commits: `5ada055a`, `8dd63040`, and `1a374911`. These changes have improved Caddy labels, fixed disk space issues, and enhanced logging for the firefox service. + +--- + +## Notes +- Generated by Gremlin on 2026-04-30T04:12:24.676Z +- Source: swarm/firefox.yaml +- Review User Guide and Changelog sections \ No newline at end of file