FOG Docker Documentation

Welcome to the FOG Docker documentation! This comprehensive guide covers everything you need to deploy and manage FOG (Free Open-source Ghost) in Docker containers.

Quick Start

Get FOG Docker up and running in minutes:

1. Download and configure:

   mkdir fog-docker && cd fog-docker
   curl -O https://raw.githubusercontent.com/88fingerslukee/fog-docker/main/docker-compose.yml
   curl -O https://raw.githubusercontent.com/88fingerslukee/fog-docker/main/.env.example
   cp .env.example .env
   

2. Edit .env with your settings:

   FOG_WEB_HOST=192.168.1.100
   FOG_DB_ROOT_PASSWORD=your-secure-password
   

3. Start FOG:

   docker compose up -d
   

4. Access FOG:
   • Web Interface: https://your-server-ip/fog/management/ (accept the self-signed certificate on first visit)
   • Default login: fog / password (change immediately!)

What is FOG Docker?

FOG Docker is a complete containerization of the FOG Project, providing:

• 🖥️ Computer Imaging: Capture and deploy disk images (FOG 1.6 finalize via in-container SSH/SFTP)
• 📦 Docker Containerization: Easy deployment and management
• 🔧 Automatic Configuration: Environment-based setup
• 🌐 Network Boot: PXE and HTTPBoot support
• 🔒 TLS modes: One FOG_TLS_MODE preset for UI, PXE, and reverse proxy
• 🔄 Migration Support: Import from existing FOG installations

Documentation Sections

Getting Started

• Installation Guide - Detailed installation instructions
• Windows (WSL2) - Lab testing on Windows with WSL and Docker
• Configuration Guide - Complete configuration options
• Network Boot Setup - PXE and HTTPBoot configuration

SSL & Security

• TLS Modes - FOG_TLS_MODE presets (web UI vs PXE)
• SSL/HTTPS Setup - SSL certificate configuration
• Reverse Proxy Setup - Deploy behind Traefik, Nginx, Apache, or Caddy

Integration & Migration

• Migration from Bare Metal - Migrate existing FOG installations
• External Database - Use external MySQL/MariaDB
• DHCP Integration - Integrate with existing DHCP servers

Reference

• Environment Variables - Complete list of configuration options (50+ variables explained)
• Troubleshooting Guide - Common issues and solutions

Common Use Cases

Single Server Setup (default)

Perfect for small to medium environments — self-signed HTTPS, no reverse proxy:

FOG_WEB_HOST=192.168.1.100
FOG_DB_ROOT_PASSWORD=your-secure-password
FOG_TLS_MODE=standard

Production with Reverse Proxy

For production environments where a proxy terminates TLS (access FOG via the proxy, not direct HTTP to the container):

FOG_WEB_HOST=fog.example.com
FOG_DB_ROOT_PASSWORD=your-secure-password
FOG_TLS_MODE=reverse-proxy

HTTP Only (lab/testing)

FOG_WEB_HOST=192.168.1.100
FOG_DB_ROOT_PASSWORD=your-secure-password
FOG_TLS_MODE=http-only

Mounted certificate (Let’s Encrypt on Apache)

FOG_WEB_HOST=fog.example.com
FOG_DB_ROOT_PASSWORD=your-secure-password
FOG_TLS_MODE=mounted-certs

Support

• GitHub Repository: 88fingerslukee/fog-docker
• FOG Project: FOGProject/fogproject
• Issues: Report bugs and request features on GitHub

---

⚠️ BETA SOFTWARE - This project is in active development and may have bugs or incomplete features.