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:

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

Edit .env with your settings:

FOG_WEB_HOST=192.168.1.100
FOG_DB_ROOT_PASSWORD=your-secure-password

Start FOG:
```
docker compose up -d
```
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 across your network
📦 Docker Containerization: Easy deployment and management
🔧 Automatic Configuration: Environment-based setup
🌐 Network Boot: PXE and HTTPBoot support
🔒 SSL/HTTPS: Multiple SSL configuration options
🔄 Migration Support: Import from existing FOG installations

Documentation Sections

Getting Started

Installation Guide - Detailed installation instructions
Configuration Guide - Complete configuration options
Network Boot Setup - PXE and HTTPBoot configuration

SSL & Security

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_HTTP_PROTOCOL=https
FOG_INTERNAL_HTTPS_ENABLED=true

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_HTTP_PROTOCOL=https
FOG_INTERNAL_HTTPS_ENABLED=false

HTTP Only (lab/testing)

FOG_WEB_HOST=192.168.1.100
FOG_DB_ROOT_PASSWORD=your-secure-password
FOG_HTTP_PROTOCOL=http
FOG_INTERNAL_HTTPS_ENABLED=false

Internal HTTPS with custom certificate

For secure internal networks with your own cert:

FOG_WEB_HOST=192.168.1.100
FOG_DB_ROOT_PASSWORD=your-secure-password
FOG_HTTP_PROTOCOL=https
FOG_INTERNAL_HTTPS_ENABLED=true
FOG_APACHE_SSL_CN=192.168.1.100

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.