docs(gremlin): update firefox
This commit is contained in:
parent
d530fa7bb8
commit
81357b2575
1 changed files with 27 additions and 31 deletions
|
|
@ -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 |
|
||||
|
||||
<Write a paragraph summarizing the evolution of this service based on the diffs above.>
|
||||
|
||||
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
|
||||
Generated by Gremlin on 2026-04-30T13:53:39.100Z
|
||||
Source: swarm/firefox.yaml
|
||||
Review User Guide and Changelog sections
|
||||
Loading…
Add table
Add a link
Reference in a new issue