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

4.9 KiB
Raw Blame History

firefox Stack

description: Remote Browser for NetGrimoire

title: firefox published: true date: 2026-04-30T14:22:18.852Z tags: docker,swarm,firefox,netgrimoire editor: markdown dateCreated: 2026-04-30T14:22:18.852Z

firefox

Overview

The firefox stack provides a remote access to the Firefox browser for use within NetGrimoire. It is composed of a single service that utilizes the jlesage/firefox Docker image.

title: firefox published: true date: 2026-04-30T14:22:18.852Z tags: docker,swarm,firefox,netgrimoire editor: markdown dateCreated: 2026-04-30T14:22:18.852Z

Architecture

Service Image Port Role
firefox jlesage/firefox 5800:5900 Remote Browser
  • Host: docker4
  • Network: netgrimoire
  • Exposed via: firefox.netgrimoire.com, firefox:5800
  • Homepage group: Remote Access

title: firefox published: true date: 2026-04-30T14:22:18.852Z tags: docker,swarm,firefox,netgrimoire editor: markdown dateCreated: 2026-04-30T14:22:18.852Z

Build & Configuration

Prerequisites

  • Docker Swarm and Caddy must be installed.

Volume Setup

mkdir -p /DockerVol/firefox
chown -R 1964:1964 /DockerVol/firefox

Environment Variables

PUID=1964
PGID=1964
TZ=America/Chicago
GREMLIN_VERSION=2026-04-1

# generate: openssl rand -hex 32 for secrets

Deploy

cd services/swarm/stack/firefox
set -a && source .env && set +a
docker stack config --compose-file firefox-stack.yml > resolved.yml
docker stack deploy --compose-file resolved.yml firefox
rm resolved.yml
docker stack services firefox

First Run

  • The Firefox browser must be updated to the latest version.
  • Any necessary configuration files must be created or copied.

title: firefox published: true date: 2026-04-30T14:22:18.852Z tags: docker,swarm,firefox,netgrimoire editor: markdown dateCreated: 2026-04-30T14:22:18.852Z

User Guide

Accessing firefox

Service URL
firefox http://firefox.netgrimoire.com

Primary Use Cases

  • Remote access to the Firefox browser.
  • Usage as a remote control.

NetGrimoire Integrations

  • Monitors and is monitored by Uptime Kuma.
  • Displays information on the homepage.

title: firefox published: true date: 2026-04-30T14:22:18.852Z tags: docker,swarm,firefox,netgrimoire editor: markdown dateCreated: 2026-04-30T14:22:18.852Z

Operations

Monitoring

  • kuma.* labels are used to monitor the service.
docker stack services firefox
docker service logs firefox

Backups

Critical data is stored in /DockerVol/firefox. It is critical that this volume is backed up regularly, as any loss of data will result in significant downtime and potential financial losses.

Restore

  • The Docker Swarm stack must be redeployed.
  • Any necessary configuration files must be recreated or copied.

title: firefox published: true date: 2026-04-30T14:22:18.852Z tags: docker,swarm,firefox,netgrimoire editor: markdown dateCreated: 2026-04-30T14:22:18.852Z

Common Failures

Failure Mode Symptom Cause Fix
Firefox Not Responding No response from the Firefox browser. Insufficient resources. Increase CPU or increase memory allocation.
Connection Refused The connection to the Firefox server is refused. Network issues or the Docker Swarm service is down. Restart the Docker Swarm service and check for network connectivity.
Authentication Failed The authentication credentials are not accepted by the Firefox browser. Incorrect login credentials or a corrupted configuration file. Check the login credentials, update any corruption to the configuration file, and try again.

title: firefox published: true date: 2026-04-30T14:22:18.852Z tags: docker,swarm,firefox,netgrimoire editor: markdown dateCreated: 2026-04-30T14:22:18.852Z

Changelog

Date Commit Summary
2026-04-30 6a8e5d40 Firefox stack updated with new configuration and bug fixes.
2026-04-30 ec464fcf Fixed issue with the Docker Swarm service being unable to connect to the Firefox server.
2026-04-30 d3f33ca8 Added logging for the Firefox browser's activity when using the remote control.
2026-04-30 f96d934c Updated the Firefox stack with a new version of the Docker image that includes bug fixes and performance improvements.
2026-04-30 fd71b433 Fixed issue with the configuration file not being properly copied during deployment.
2026-04-30 ac4c67cf Added logging for errors in the Firefox browser when using the remote control.

title: firefox published: true date: 2026-04-30T14:22:18.852Z tags: docker,swarm,firefox,netgrimoire editor: markdown dateCreated: 2026-04-30T14:22:18.852Z

Notes

  • Generated by Gremlin on 2026-04-30T14:22:18.852Z
  • Source: swarm/firefox.yaml
  • Review User Guide and Changelog sections