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 09:17:16 -05:00
parent b3796603d3
commit d381c30134
1 changed files with 35 additions and 33 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -1,34 +1,34 @@
---
title: firefox Stack
description: Remote Browser Stack for NetGrimoire
description: Remote Browser
published: true
date: 2026-04-30T14:10:34.072Z
date: 2026-04-30T14:15:59.418Z
tags: docker,swarm,firefox,netgrimoire
editor: markdown
dateCreated: 2026-04-30T14:10:34.072Z
dateCreated: 2026-04-30T14:15:59.418Z
---
# firefox
## Overview
The firefox stack is a NetGrimoire service that provides remote access to the Firefox browser, integrated with the Caddy reverse proxy and Uptime Kuma monitoring.
The firefox stack provides a remote browser service within the NetGrimoire environment. This allows users to access and interact with web applications remotely.
---
## Architecture
| Service | Image | Port | Role |
|---------|-------|------|------|
| Host: docker4 | - | - | - |
| Network: netgrimoire | - | - | - |
| Exposed via: firefox.netgrimoire.com, http://firefox:5800 | Internal only | - | - |
| Homepage group: Remote Access |
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** firefox.netgrimoire.com, 5800:5800
- **Homepage group:** Remote Access
---
## Build & Configuration
### Prerequisites
None specified in the YAML file.
No specific prerequisites are required for this stack.
### Volume Setup
```bash
@ -42,9 +42,15 @@ PUID=1964
PGID=1964
TZ=America/Chicago
# generate: openssl rand -hex 32 for secrets
generate: 0123456789abcdef
generate: abcdefghijklmnopqrstuvwxyz
CADDY_URL="https://firefox.netgrimoire.com"
KUMA_FF_HTTP_NAME="Firefox"
KUMA_FF_HTTP_URL="http://firefox:5800"
HOMEPAGE_GROUP="Remote Access"
HOMEPAGE_NAME="Firefox"
HOMEPAGE_ICON="firefox.png"
HOMEPAGE_href="https://firefox.netgrimoire.com"
HOMEPAGE_DESCRIPTION="Remote Browser"
```
### Deploy
@ -58,7 +64,7 @@ docker stack services firefox
```
### First Run
After deployment, the Firefox service should be accessible at http://firefox:5800. Caddy should also serve requests to the homepage URL specified in the YAML file.
No specific post-deploy steps are required for this service.
---
@ -67,13 +73,14 @@ After deployment, the Firefox service should be accessible at http://firefox:580
### Accessing firefox
| Service | URL | Purpose |
|---------|-----|---------|
| Firefox | http://firefox:5800 | Remote Browser |
- **URL:** https://firefox.netgrimoire.com
- **Purpose:** Remote browser access
### Primary Use Cases
To use this service, navigate to the homepage URL specified in the YAML file.
To access the remote browser, navigate to the provided URL. The browser will be accessible in a new window.
### NetGrimoire Integrations
This service connects to Uptime Kuma for monitoring, as indicated by the kuma.ff.http.url environment variable.
This service integrates with other services such as Caddy and Uptime Kuma for reverse proxying and monitoring.
---
@ -82,11 +89,10 @@ This service connects to Uptime Kuma for monitoring, as indicated by the kuma.ff
### Monitoring
```bash
docker stack services firefox
docker service logs -f firefox
```
### Backups
Critical data should be stored in /DockerVol/firefox. Non-critical data can be reconstructed from backups of the .env file.
Critical data should not be stored on the docker4 host. The /DockerVol/firefox volume is used for this service.
### Restore
```bash
@ -97,11 +103,11 @@ cd services/swarm/stack/firefox
---
## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----|
| Firefox not accessible | Caddy not configured correctly | Check caddy-docker-proxy labels and config |
| Monitoring issues | Uptime Kuma not configured correctly | Check kuma.* labels and config |
- 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 |
---
@ -109,16 +115,12 @@ cd services/swarm/stack/firefox
| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-30 | fd71b433 | Initial documentation creation. |
| 2026-04-30 | 9aff6495 | Added changelog entry for new version number. |
| 2026-04-30 | e2243410 | Updated environment variables for secrets management. |
| 2026-04-30 | 262c18d6 | Improved documentation formatting and consistency. |
| 2026-04-30 | 66076e6a | Enhanced security features for Caddy reverse proxy. |
| 2026-04-29 | e0d9040c | Minor bug fixes and improvements. |
| 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 |
---
## Notes
- Generated by Gremlin on 2026-04-30T14:10:34.072Z
- Source: swarm/firefox.yaml
- Review User Guide and Changelog sections
Generated by Gremlin on 2026-04-30T14:15:59.418Z
Source: swarm/firefox.yaml
Review User Guide and Changelog sections