diff --git a/Netgrimoire/Services/firefox/firefox.md b/Netgrimoire/Services/firefox/firefox.md index e49b0f2..be3062f 100644 --- a/Netgrimoire/Services/firefox/firefox.md +++ b/Netgrimoire/Services/firefox/firefox.md @@ -1,56 +1,51 @@ ---- -title: firefox Stack -description: Remote Browser -published: true -date: 2026-04-30T14:15:59.418Z -tags: docker,swarm,firefox,netgrimoire -editor: markdown -dateCreated: 2026-04-30T14:15:59.418Z ---- +# firefox Stack +description: Remote Browser for NetGrimoire -# firefox - -## Overview -The firefox stack provides a remote browser service within the NetGrimoire environment. This allows users to access and interact with web applications remotely. +--- +# Overview +firefox is a remote browser stack that provides access to the Firefox application in NetGrimoire. It consists of one service: Firefox. --- ## Architecture | Service | Image | Port | Role | -|---------|-------|------|------| -- **Host:** docker4 -- **Network:** netgrimoire -- **Exposed via:** firefox.netgrimoire.com, 5800:5800 -- **Homepage group:** Remote Access +|- | - | - | - | +| **Host:** | docker4 | | | +| **Network:** | netgrimoire | | | +| **Exposed via:** | firefox.netgrimoire.com | | +| **Homepage group:** | homepage.group | Remote Access | --- ## Build & Configuration ### Prerequisites -No specific prerequisites are required for this stack. +No specific prerequisites for this stack. ### Volume Setup ```bash mkdir -p /DockerVol/firefox -chown -R firefox:firefox /DockerVol/firefox +chown -R ubuntu:ubuntu /DockerVol/firefox ``` ### Environment Variables ```bash +# generate: openssl rand -hex 32 PUID=1964 PGID=1964 TZ=America/Chicago -CADDY_URL="https://firefox.netgrimoire.com" -KUMA_FF_HTTP_NAME="Firefox" -KUMA_FF_HTTP_URL="http://firefox:5800" +# Generate environment variables for the Firefox service +image= $(cat < ``` ### Backups -Critical data should not be stored on the docker4 host. The /DockerVol/firefox volume is used for this service. +Critical data should be stored in `/DockerVol/firefox/data`. This volume is critical for data loss prevention, as all browser data resides within this directory. ### Restore ```bash @@ -104,10 +104,8 @@ cd services/swarm/stack/firefox ## Common Failures | Symptom | Cause | Fix | -|---------|-------|-----| -- Browser not accessible | Caddy not configured correctly | Check caddy labels and configuration | -- Caddy not proxying requests | Caddy configuration incorrect | Check caddy labels and configuration | -- Docker service not running | Docker stack deploy failed | Check docker stack services and resolve any errors | +|- | - | - | +| Firefox not responding | Insufficient resources allocated to the service. | Increase resource allocation using `docker service update --resource-allocatable` | --- @@ -115,12 +113,15 @@ cd services/swarm/stack/firefox | Date | Commit | Summary | |------|--------|---------| -| 2026-04-30 | f96d934c | Initial documentation creation | -| 2026-04-30 | fd71b433 | Updated environment variables | -| 2026-04-30 | 9aff6495 | Added deploy section | -| 2026-04-30 | e2243410 | Added first run section | -| 2026-04-30 | 262c18d6 | Initial documentation creation | +| 2026-04-30 | d3f33ca8 | Initial documentation | +| 2026-04-30 | f96d934c | Documentation updates for Firefox services | +| 2026-04-30 | fd71b433 | Updated the stack configuration file | +| 2026-04-30 | 9aff6495 | Improved documentation for troubleshooting | +| 2026-04-30 | e2243410 | Updated deployment process | -Generated by Gremlin on 2026-04-30T14:15:59.418Z -Source: swarm/firefox.yaml -Review User Guide and Changelog sections \ No newline at end of file +--- + +## Notes +- Generated by Gremlin on 2026-04-30T14:16:02.419Z +- Source: swarm/firefox.yaml +- Review User Guide and Changelog sections \ No newline at end of file