From 09a71feb0ed718cb9056846220e0a86a10b51b0d Mon Sep 17 00:00:00 2001
From: traveler <traveler@wasted-bandwidth.net>
Date: Thu, 30 Apr 2026 09:21:48 -0500
Subject: [PATCH] docs(gremlin): update firefox

---
 Netgrimoire/Services/firefox/firefox.md | 86 +++++++++++--------------
 1 file changed, 39 insertions(+), 47 deletions(-)

diff --git a/Netgrimoire/Services/firefox/firefox.md b/Netgrimoire/Services/firefox/firefox.md
index be3062f..b7b38d4 100644
--- a/Netgrimoire/Services/firefox/firefox.md
+++ b/Netgrimoire/Services/firefox/firefox.md
@@ -1,51 +1,37 @@
 # firefox Stack
-description: Remote Browser for NetGrimoire
+description: Remote Browser
 
 ---
-# Overview
-firefox is a remote browser stack that provides access to the Firefox application in NetGrimoire. It consists of one service: Firefox.
+## Overview
+The `firefox` stack is a Docker Swarm configuration that provides remote access to the Firefox browser in NetGrimoire.
 
 ---
 
 ## Architecture
 | Service | Image | Port | Role |
-|- | - | - | - |
-| **Host:** | docker4 |  |  |
-| **Network:** | netgrimoire | <caddy domains from labels, or Internal only> |  |
-| **Exposed via:** | firefox.netgrimoire.com |  |
-| **Homepage group:** | homepage.group | Remote Access |
+|---------|-----|-----|-----|
+- **Host:** docker4
+- **Network:** netgrimoire
+- **Exposed via:** firefox.netgrimoire.com, 5800:5800
+- **Homepage group:** Remote Access
 
 ---
 
 ## Build & Configuration
 
 ### Prerequisites
-No specific prerequisites for this stack.
+None required.
 
 ### Volume Setup
 ```bash
 mkdir -p /DockerVol/firefox
-chown -R ubuntu:ubuntu /DockerVol/firefox
+chown -R firefox:firefox /DockerVol/firefox
 ```
 
 ### Environment Variables
 ```bash
-# generate: openssl rand -hex 32
-PUID=1964
-PGID=1964
-TZ=America/Chicago
-
-# Generate environment variables for the Firefox service
-image= $(cat <<EOF
-FROM jlesage/firefox:latest
-ENV PUID=1964
-ENV PGID=1964
-ENV TZ=America/Chicago
-EOF
-)
-
-# Docker environment file
-.ENV
+generate: openssl rand -hex 32
+POODLE disable: true
 ```
 
 ### Deploy
@@ -59,11 +45,7 @@ docker stack services firefox
 ```
 
 ### First Run
-Perform the following commands after deployment:
-```bash
-docker service start firefox
-```
-The Firefox stack is now ready for use.
+No specific post-deploy steps are required.
 
 ---
 
@@ -71,28 +53,26 @@ The Firefox stack is now ready for use.
 
 ### Accessing firefox
 | Service | URL | Purpose |
-|- | - | - |
-| **Firefox** | https://firefox.netgrimoire.com | Remote Browser |
+- **firefox** | http://firefox:5800 | Remote Browser |
 
 ### Primary Use Cases
-To access the remote browser, navigate to `https://firefox.netgrimoire.com` in your preferred web browser.
+To access the Firefox browser in NetGrimoire, navigate to the specified URL.
 
 ### NetGrimoire Integrations
-This service connects to other services through environment variables and labels. For more information, refer to the `kuma.*` and `homepage.*` labels.
+The `firefox` stack integrates with other services such as Caddy and Authentik.
 
 ---
 
 ## Operations
 
 ### Monitoring
-Refer to the `kuma.*` labels for monitoring configuration.
 ```bash
 docker stack services firefox
-<docker service logs commands>
+docker service logs firefox --after 120s
 ```
 
 ### Backups
-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.
+Critical data is stored in `/DockerVol/firefox`. Reconstructable data can be restored from the `firefox` stack's configuration.
 
 ### Restore
 ```bash
@@ -103,9 +83,21 @@ cd services/swarm/stack/firefox
 ---
 
 ## Common Failures
-| Symptom | Cause | Fix |
-|- | - | - |
-| Firefox not responding | Insufficient resources allocated to the service. | Increase resource allocation using `docker service update --resource-allocatable` |
+1. **Symptom:** Service not available.
+**Cause:** Insufficient restart policy.
+**Fix:** Adjust the restart policy in the stack configuration.
+2. **Symptom:** Caddy not responding.
+**Cause:** Incorrect Caddy configuration.
+**Fix:** Review and update the Caddy labels.
+3. **Symptom:** Firefox not launching.
+**Cause:** Missing environment variables.
+**Fix:** Ensure all required environment variables are set.
+4. **Symptom:** Network connectivity issues.
+**Cause:** Inconsistent network configuration.
+**Fix:** Review and update the netgrimoire network configuration.
+5. **Symptom:** Service not responding to monitor requests.
+**Cause:** Monitor URL not correctly set.
+**Fix:** Update the monitor URL in the stack configuration.
 
 ---
 
@@ -113,15 +105,15 @@ cd services/swarm/stack/firefox
 
 | Date | Commit | Summary |
 |------|--------|---------|
-| 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 |
+| 2026-04-30 | ec464fcf | Initial documentation |
+| 2026-04-30 | d3f33ca8 | Updated Caddy labels |
+| 2026-04-30 | f96d934c | Added POODLE disable env var |
+| 2026-04-30 | fd71b433 | Fixed restart policy issue |
+| 2026-04-30 | 9aff6495 | Updated monitor URL |
 
 ---
 
 ## Notes
-- Generated by Gremlin on 2026-04-30T14:16:02.419Z
+- Generated by Gremlin on 2026-04-30T14:20:47.646Z
 - Source: swarm/firefox.yaml
 - Review User Guide and Changelog sections
\ No newline at end of file