---
title: firefox Stack
description: Remote Browser
published: true
date: 2026-05-01T02:40:45.857Z
tags: docker,swarm,firefox,netgrimoire
editor: markdown
dateCreated: 2026-05-01T02:40:45.857Z
---

# firefox

## Overview
The firefox stack in NetGrimoire provides a remote access to a browser instance running on Firefox. It utilizes Docker Swarm for orchestration and Caddy as the reverse proxy.

## Architecture

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

---

## Build & Configuration

### Prerequisites
No specific prerequisites for this stack.

### Volume Setup
```bash
mkdir -p /DockerVol/firefox
chown -R user:group /DockerVol/firefox
```

### Environment Variables
```bash
PUID=1964
PGID=1964
TZ=America/Chicago

generate: openssl rand -hex 32
```

### 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.

---

## User Guide

### Accessing firefox
| Service | URL | Purpose |
|---------|-----|---------|
- **URL:** http://firefox:5800
- **Purpose:** Remote access to the Firefox browser instance

### Primary Use Cases
To use this stack in NetGrimoire, navigate to `http://firefox.netgrimoire.com` and start a new session.

### NetGrimoire Integrations
This service connects to other services via environment variables and labels.

---

## Operations

### Monitoring
```bash
docker stack services firefox
<docker service logs commands>
```

### Backups
Critical vs reconstructable /DockerVol/firefox paths. Store backups on a secure location.

### Restore
```bash
cd services/swarm/stack/firefox
./deploy.sh
```

---

## Common Failures

| Symptom | Cause | Fix |
|---------|------|-----|
- No response from the Firefox browser instance | Incorrect Docker stack configuration | Check `docker stack config` output and correct it.
- Firefox browser instance is not accessible via Caddy | Caddy is not running correctly | Check Caddy logs for errors and restart it if necessary.

---

## Changelog

| Date | Commit | Summary |
|------|--------|---------|
- 2026-04-30 | f96d934c | Initial documentation created. |

Generated by Gremlin on 2026-05-01T02:40:45.857Z
Source: swarm/firefox.yaml
Review User Guide and Changelog sections