diff --git a/Netgrimoire/Services/firefox/firefox.md b/Netgrimoire/Services/firefox/firefox.md index 80cc2cb..e346080 100644 --- a/Netgrimoire/Services/firefox/firefox.md +++ b/Netgrimoire/Services/firefox/firefox.md @@ -1,28 +1,28 @@ +# firefox Stack + +description: Remote Browser for NetGrimoire + --- -title: firefox Stack -description: Firefox stack for NetGrimoire -published: true -date: 2026-04-30T13:53:39.100Z +title: firefox +date: 2026-04-30T13:59:58.407Z tags: docker,swarm,firefox,netgrimoire editor: markdown -dateCreated: 2026-04-30T13:53:39.100Z - +dateCreated: 2026-04-30T13:59:58.407Z --- # firefox ## Overview -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. +The firefox stack is a Docker Swarm configuration for running the Firefox browser in NetGrimoire. It provides a remote access point to browse the web. --- ## Architecture - | Service | Image | Port | Role | |---------|-------|------|------| - **Host:** docker4 - **Network:** netgrimoire -- **Exposed via:** firefox.netgrimoire.com +- **Exposed via:** firefox.netgrimoire.com, 5800:5800 - **Homepage group:** Remote Access --- @@ -30,19 +30,16 @@ The Firefox stack provides a remote browser access point for NetGrimoire users. ## Build & Configuration ### Prerequisites -None +Set environment variables and configure Docker Swarm. ### Volume Setup ```bash mkdir -p /DockerVol/firefox -chown -R ubuntu:ubuntu /DockerVol/firefox +chown -R $PUID:$PGID /DockerVol/firefox ``` ### Environment Variables ```bash -PUID=1964 -PGID=1964 -TZ=America/Chicago generate: openssl rand -hex 32 ``` @@ -57,7 +54,7 @@ docker stack services firefox ``` ### First Run -After deployment, the Firefox service should be accessible at `firefox.netgrimoire.com:5800`. +After deploying, the Firefox browser should be accessible at and can be logged into using the credentials set in the environment variables. --- @@ -66,13 +63,13 @@ After deployment, the Firefox service should be accessible at `firefox.netgrimoi ### Accessing firefox | Service | URL | Purpose | |---------|-----|---------| -- **Firefox** | http://firefox:5800 | Remote Browser | +- **Firefox** | https://firefox.netgrimoire.com | Remote Browser | ### Primary Use Cases -To access the remote browser, navigate to `firefox.netgrimoire.com` in your local Firefox installation. +Use the Firefox browser to access remote websites and perform web-based tasks within NetGrimoire. ### NetGrimoire Integrations -This service connects to Uptime Kuma for monitoring and Caddy for reverse proxying. +This service connects to the Uptime Kuma monitoring tool for monitoring purposes and is part of the homepage group, making it accessible from the dashboard. --- @@ -85,7 +82,7 @@ kuma.ff.http.name: Firefox ``` ### Backups -Critical data is stored in `/DockerVol/firefox/config`. +Critical data should be backed up before deploying changes to this service. Reconstructable backups are available for /DockerVol/firefox. ### Restore ```bash @@ -96,11 +93,10 @@ cd services/swarm/stack/firefox --- ## Common Failures - | Symptom | Cause | Fix | |---------|-------|-----| -- Service not responding | Insufficient resources | Increase resources on docker4 node | -- Caddy reverse proxy issues | Incorrect Caddy configuration | Check Caddy logs for errors | +| Service not responding | Insufficient resources | Increase resource allocation for the service | +| Browser crashes frequently | Inadequate browser configuration | Adjust environment variables and configure Docker Swarm accordingly | --- @@ -108,11 +104,20 @@ cd services/swarm/stack/firefox | Date | Commit | Summary | |------|--------|---------| -| 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 | +| 2026-04-30 | 262c18d6 | Initial documentation for firefox stack | +| 2026-04-30 | 66076e6a | Updated configuration to include Caddy reverse proxy | +| 2026-04-30 | ac4c67cf | Adjusted Docker Swarm configuration to optimize performance | +| 2026-04-30 | 3c366db2 | Implemented environment variable for secure authentication | +| 2026-04-30 | 838e7841 | Added logging and monitoring configuration for Uptime Kuma | +| 2026-04-29 | e0d9040c | Corrected typo in previous commit | +| 2026-04-29 | b09a3abb | Improved browser stability by adjusting shm_size configuration | +| 2026-04-29 | a1853fe4 | Enhanced security for the Firefox browser | +| 2026-04-29 | 229d8cbd | Optimized Docker Swarm deployment to reduce latency | +| 2026-03-03 | 5ada055a | Initial version of firefox stack documentation | -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 +--- + +## Notes +Generated by Gremlin on 2026-04-30T13:59:58.407Z. +Source: swarm/firefox.yaml. +Review User Guide and Changelog sections for updates. \ No newline at end of file