Skip to main content

🧠 Homelab Overview

A modern Docker Swarm cluster for distributed container management, supporting development, testing, and self-hosted services.

🌐 Network Configuration

  • All nodes connected via single physical switch
  • DHCP reservations for static internal IPs
  • All nodes on the same subnet
  • Full LAN communication between nodes
  • Standard router with flat network topology

🖥️ Hardware Layout

The cluster consists of 3 Mini PCs configured as follows:

CI-01
Swarm Manager
Orchestrator, Portainer UI
CI-02
Swarm Worker
Executes services
CI-03
Swarm Worker
Executes services

🧱 Base OS

All nodes are running Fedora Server, providing a stable and secure foundation for the Docker environment.

Fedora Server

🐳 Docker + Swarm

  • Docker CE installed and active on all nodes
  • Docker Swarm mode cluster configuration:
    • CI-01: Manager node
    • CI-02 & CI-03: Worker nodes
  • Distributed container management across the cluster
Docker CE Docker Swarm

🖥️ Portainer CE

Running in swarm mode on CI-01, providing a centralized web UI for:

  • Docker swarm management across all nodes
  • Orchestration of stacks and services
  • Node health and resource monitoring
  • Logs, volumes, and network configuration
Portainer CE Swarm Mode

Enabled Capabilities

  • Centralized app management
  • Scalable Docker deployment
  • Pre-release app testing and staging
  • Ready for future expansion:
    • GitHub Actions runners
    • Reverse proxy and SSL (Traefik)
    • Monitoring tools (Netdata, Glances)
    • Self-hosted services (Gitea, Nextcloud, Jellyfin)
Back to Research