traveler/Netgrimoire
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(gremlin): update firefox

Browse source
This commit is contained in:
traveler 2026-04-30 08:55:00 -05:00
parent d530fa7bb8
commit 81357b2575
1 changed files with 27 additions and 31 deletions
Download patch file Download diff file Expand all files Collapse all files

58
Netgrimoire/Services/firefox/firefox.md
View file

@ -1,26 +1,28 @@
--- ---
title: firefox Stack title: firefox Stack
description: Remote Browser for NetGrimoire description: Firefox stack for NetGrimoire
published: true published: true
date: 2026-04-30T13:43:27.754Z date: 2026-04-30T13:53:39.100Z
tags: docker,swarm,firefox,netgrimoire tags: docker,swarm,firefox,netgrimoire
editor: markdown editor: markdown
dateCreated: 2026-04-30T13:43:27.754Z dateCreated: 2026-04-30T13:53:39.100Z
--- ---
# firefox # firefox
## Overview ## 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 ## Architecture
| Service | Image | Port | Role | | Service | Image | Port | Role |
|---------|-----|-----|---------| |---------|-------|------|------|
- **Host:** docker4 - **Host:** docker4
- **Network:** netgrimoire - **Network:** netgrimoire
- **Exposed via:** firefox.netgrimoire.com, 5800:5800 - **Exposed via:** firefox.netgrimoire.com
- **Homepage group:** Remote Access - **Homepage group:** Remote Access
--- ---
@ -33,7 +35,7 @@ None
### Volume Setup ### Volume Setup
```bash ```bash
mkdir -p /DockerVol/firefox mkdir -p /DockerVol/firefox
chown -R docker4:docker4 /DockerVol/firefox chown -R ubuntu:ubuntu /DockerVol/firefox
``` ```
### Environment Variables ### Environment Variables
@ -41,6 +43,7 @@ chown -R docker4:docker4 /DockerVol/firefox
PUID=1964 PUID=1964
PGID=1964 PGID=1964
TZ=America/Chicago TZ=America/Chicago
generate: openssl rand -hex 32
``` ```
### Deploy ### Deploy
@ -54,7 +57,7 @@ docker stack services firefox
``` ```
### First Run ### 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 ### Accessing firefox
| Service | URL | Purpose | | Service | URL | Purpose |
|---------|-----|---------| |---------|-----|---------|
- Firefox | http://firefox:5800 | Remote Browser - **Firefox** | http://firefox:5800 | Remote Browser |
### Primary Use Cases ### 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 ### 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 ### Monitoring
```bash ```bash
docker stack services firefox docker stack services firefox
docker service logs firefox kuma.ff.http.name: Firefox
``` ```
### Backups ### 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 ### Restore
```bash ```bash
@ -93,10 +96,11 @@ cd services/swarm/stack/firefox
--- ---
## Common Failures ## Common Failures
| Symptom | Cause | Fix | | Symptom | Cause | Fix |
|---------|------|-----| |---------|-------|-----|
| Browser Not Responding | Insufficient Caddy resources | Scale Caddy service to increase resource allocation | - Service not responding | Insufficient resources | Increase resources on docker4 node |
| Login Issues | Incorrect credentials | Verify and update NetGrimoire credentials | - Caddy reverse proxy issues | Incorrect Caddy configuration | Check Caddy logs for errors |
--- ---
@ -104,19 +108,11 @@ cd services/swarm/stack/firefox
| Date | Commit | Summary | | Date | Commit | Summary |
|------|--------|---------| |------|--------|---------|
| 2026-04-30 | ac4c67cf | Initial documentation for firefox stack | | 2026-04-30 | 66076e6a | Initial documentation creation |
| 2026-04-30 | 3c366db2 | Updated firewall rules to allow incoming traffic on port 5800 | | 2026-04-29 | e0d9040c | Update Caddy reverse proxy configuration |
| 2026-04-30 | 838e7841 | Fixed Caddy reverse proxy configuration to use HTTPS | | 2026-04-03 | b09a3abb | Improve resource allocation for docker4 node |
| 2026-04-29 | e0d9040c | Updated Docker Swarm configuration to use latest image version of Firefox | | 2026-03-03 | 5ada055a | Initial deployment of Firefox service |
| 2026-04-29 | b09a3abb | Added security measure to restrict incoming traffic on port 5800 |
<Write a paragraph summarizing the evolution of this service based on the diffs above.> Generated by Gremlin on 2026-04-30T13:53:39.100Z
Source: swarm/firefox.yaml
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. Review User Guide and Changelog sections
---
## Notes
- Generated by Gremlin on 2026-04-30T13:43:27.754Z
- Source: swarm/firefox.yaml
- Review User Guide and Changelog sections