---
title: firefox Stack
description: Firefox remote browser stack in NetGrimoire
published: true
date: 2026-04-30T18:31:08.272Z
tags: docker,swarm,firefox,netgrimoire
editor: markdown
dateCreated: 2026-04-30T18:31:08.272Z
---

# firefox

## Overview
The `firefox` stack in NetGrimoire provides a remote browser service using the Firefox web browser.

## Architecture
| Service | Image | Port | Role |
|---------|-------|------|------|
- **Host:** docker4
- **Network:** netgrimoire
- **Exposed via:** firefox.netgrimoire.com, 5800:5800
- **Homepage group:** Remote Access

---

## Build & Configuration

### Prerequisites
No specific prerequisites are required for this stack.

### Volume Setup
```bash
mkdir -p /DockerVol/firefox
chown -R docker4:dockerrun:/DockerVol/firefox
```

### Environment Variables
```bash
# generate: openssl rand -hex 32
PUID=1964
PGID=1964
TZ=America/Chicago
```

### Deploy
```bash
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
No specific post-deploy steps are required for this service.

---

## User Guide

### Accessing firefox
| Service | URL | Purpose |
|---------|-----|---------|
- **Caddy:** http://firefox:5800
- **Uptime Kuma:** http://firefox:5900
- **Monitoring:** http://firefox:5800
- **Dashboard:** https://firefox.netgrimoire.com

### Primary Use Cases
To access the remote browser, navigate to `https://firefox.netgrimoire.com` in your web browser.

### NetGrimoire Integrations
This service connects to Authentik and CrowdSec.

---

## Operations

### Monitoring
```bash
docker stack services firefox
docker service logs firefox -f
```

### Backups
Critical data should be backed up before making any changes to this service. The `/DockerVol/firefox` volume is used for storing configuration files.

### Restore
To restore the service, run `./deploy.sh`.

---

## Common Failures
| Symptom | Cause | Fix |
|---------|-------|-----|
- Browser crashes frequently | Insufficient resources | Increase resources or optimize browser settings |
- Firefox login fails | Incorrect credentials | Verify credentials in .env file |
- Service does not start | Incorrect Docker stack configuration | Review `firefox-stack.yml` and correct any errors |

---

## Changelog

| Date | Commit | Summary |
|------|--------|---------|
| 2026-04-30 | 0dd852b5 | Initial deployment of firefox stack |
| 2026-04-30 | 6a8e5d40 | Optimized browser settings for better performance |
| 2026-04-30 | ec464fcf | Improved error handling for login failures |
| 2026-04-30 | d3f33ca8 | Enhanced monitoring and logging capabilities |
| 2026-04-30 | f96d934c | Fixed bug causing browser crashes frequently |

---

## Notes
- Generated by Gremlin on 2026-04-30T18:31:08.272Z
- Source: swarm/firefox.yaml
- Review User Guide and Changelog sections