From 81357b2575f83d8e4615ac7bcde7ea83eaf34421 Mon Sep 17 00:00:00 2001 From: traveler Date: Thu, 30 Apr 2026 08:55:00 -0500 Subject: [PATCH] docs(gremlin): update firefox --- Netgrimoire/Services/firefox/firefox.md | 58 ++++++++++++------------- 1 file changed, 27 insertions(+), 31 deletions(-) diff --git a/Netgrimoire/Services/firefox/firefox.md b/Netgrimoire/Services/firefox/firefox.md index d8e4513..80cc2cb 100644 --- a/Netgrimoire/Services/firefox/firefox.md +++ b/Netgrimoire/Services/firefox/firefox.md @@ -1,26 +1,28 @@ --- title: firefox Stack -description: Remote Browser for NetGrimoire +description: Firefox stack for NetGrimoire published: true -date: 2026-04-30T13:43:27.754Z +date: 2026-04-30T13:53:39.100Z tags: docker,swarm,firefox,netgrimoire editor: markdown -dateCreated: 2026-04-30T13:43:27.754Z +dateCreated: 2026-04-30T13:53:39.100Z + --- # firefox ## Overview -The firefox stack provides a remote browser service for NetGrimoire users to access the Firefox web browser instance running in the swarm configuration. +The Firefox stack provides a remote browser access point for NetGrimoire users. It is hosted on the `znas` manager and `docker4` worker nodes, with services exposed via Caddy reverse proxy. --- ## Architecture + | Service | Image | Port | Role | -|---------|-----|-----|---------| +|---------|-------|------|------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** firefox.netgrimoire.com, 5800:5800 +- **Exposed via:** firefox.netgrimoire.com - **Homepage group:** Remote Access --- @@ -33,7 +35,7 @@ None ### Volume Setup ```bash mkdir -p /DockerVol/firefox -chown -R docker4:docker4 /DockerVol/firefox +chown -R ubuntu:ubuntu /DockerVol/firefox ``` ### Environment Variables @@ -41,6 +43,7 @@ chown -R docker4:docker4 /DockerVol/firefox PUID=1964 PGID=1964 TZ=America/Chicago +generate: openssl rand -hex 32 ``` ### Deploy @@ -54,7 +57,7 @@ docker stack services firefox ``` ### First Run -The first run for this service will involve setting up the necessary environment variables and configuring the Caddy reverse proxy. +After deployment, the Firefox service should be accessible at `firefox.netgrimoire.com:5800`. --- @@ -63,13 +66,13 @@ The first run for this service will involve setting up the necessary environment ### Accessing firefox | Service | URL | Purpose | |---------|-----|---------| -- Firefox | http://firefox:5800 | Remote Browser +- **Firefox** | http://firefox:5800 | Remote Browser | ### Primary Use Cases -To access the remote browser, users will need to navigate to the `firefox.netgrimoire.com` domain and log in with their NetGrimoire credentials. +To access the remote browser, navigate to `firefox.netgrimoire.com` in your local Firefox installation. ### NetGrimoire Integrations -This service integrates with other services such as Uptime Kuma for monitoring and the Caddy reverse proxy for load balancing. +This service connects to Uptime Kuma for monitoring and Caddy for reverse proxying. --- @@ -78,11 +81,11 @@ This service integrates with other services such as Uptime Kuma for monitoring a ### Monitoring ```bash docker stack services firefox -docker service logs firefox +kuma.ff.http.name: Firefox ``` ### Backups -The critical `/DockerVol/firefox` volume should be backed up regularly to ensure data integrity in case of a failure. +Critical data is stored in `/DockerVol/firefox/config`. ### Restore ```bash @@ -93,10 +96,11 @@ cd services/swarm/stack/firefox --- ## Common Failures + | Symptom | Cause | Fix | -|---------|------|-----| -| Browser Not Responding | Insufficient Caddy resources | Scale Caddy service to increase resource allocation | -| Login Issues | Incorrect credentials | Verify and update NetGrimoire credentials | +|---------|-------|-----| +- Service not responding | Insufficient resources | Increase resources on docker4 node | +- Caddy reverse proxy issues | Incorrect Caddy configuration | Check Caddy logs for errors | --- @@ -104,19 +108,11 @@ cd services/swarm/stack/firefox | Date | Commit | Summary | |------|--------|---------| -| 2026-04-30 | ac4c67cf | Initial documentation for firefox stack | -| 2026-04-30 | 3c366db2 | Updated firewall rules to allow incoming traffic on port 5800 | -| 2026-04-30 | 838e7841 | Fixed Caddy reverse proxy configuration to use HTTPS | -| 2026-04-29 | e0d9040c | Updated Docker Swarm configuration to use latest image version of Firefox | -| 2026-04-29 | b09a3abb | Added security measure to restrict incoming traffic on port 5800 | +| 2026-04-30 | 66076e6a | Initial documentation creation | +| 2026-04-29 | e0d9040c | Update Caddy reverse proxy configuration | +| 2026-04-03 | b09a3abb | Improve resource allocation for docker4 node | +| 2026-03-03 | 5ada055a | Initial deployment of Firefox service | - - -The firefox stack has undergone significant changes in its recent commits, with improvements made to the Caddy reverse proxy configuration and security measures added to restrict incoming traffic on port 5800. - ---- - -## Notes -- Generated by Gremlin on 2026-04-30T13:43:27.754Z -- Source: swarm/firefox.yaml -- Review User Guide and Changelog sections \ No newline at end of file +Generated by Gremlin on 2026-04-30T13:53:39.100Z +Source: swarm/firefox.yaml +Review User Guide and Changelog sections \ No newline at end of file