Home

Welcome to the comprehensive systemd-managed Docker Compose framework for self-hosted infrastructure!

What is This?

A modular collection of Docker Compose files and management tools for orchestrating a complete self-hosted environment. This project solves Docker's unreliable auto-start mechanisms through proper systemd integration and dependency management.

Key Services

Core Infrastructure

• Traefik - Reverse proxy with automatic SSL/TLS (Let's Encrypt + Cloudflare)
• Portainer - Docker container management UI
• Homepage - Unified dashboard for all services

AI/ML Stack

• Ollama - Local LLM inference engine
• Open WebUI - Modern web interface for LLMs
• LibreChat - Advanced chat application
• Text Embeddings - HuggingFace TEI service
• SwarmUI - Stable Diffusion image generation
• RisuAI - Character AI and roleplay platform

Database Layer

• MongoDB - NoSQL document database
• PostgreSQL + pgvector - SQL database with vector embeddings
• Qdrant - Specialized vector database with GPU support

Media Services

• Plex Media Server - Media streaming with GPU transcoding
• Tautulli - Plex analytics and monitoring
• StashApp - Personal media server and manager

Core Features

• Systemd Integration - Reliable service orchestration with dependency management
• Modular Architecture - Independent, reusable service stacks
• Network Isolation - 5 isolated Docker networks (proxy, database, genai, auth, metrics)
• GPU Acceleration - NVIDIA support for AI inference and transcoding
• Automatic SSL/TLS - Let's Encrypt certificates via Cloudflare DNS
• Configuration Management - Flexible environment system with secret support
• Custom Docker Plugins - Enhanced CLI tools for image/container management

Quick Navigation

🚀 New Users Start Here

1. Prerequisites - System requirements and dependencies
2. Quick Start - Get up and running in 5 minutes
3. Domain & SSL Setup - Configure SSL certificates
4. Configuration Guide - Environment and secrets management

📚 Core Documentation

• Architecture Overview - System design and network topology
• Systemd Integration - Why systemd and how it works

🛠️ Service Documentation

• Core Services - Traefik, Portainer, Homepage
• Database Stack - MongoDB, PostgreSQL, Qdrant
• GenAI Services - AI/ML service stack
• Media Services - Plex and StashApp

🔧 System Management

• Service Management - Using composectl to manage services
• Docker Compose Wrapper - Enhanced compose command
• Docker CLI Plugins - Custom Docker extensions

📖 Operations & Reference

• Troubleshooting - Common issues and solutions
• Environment Variables - Complete variable reference
• Port Reference - Service ports and endpoints

Requirements

• Linux with systemd
• Docker Engine 20.10+ and Docker Compose V2
• Python 3.11+ (for management scripts)
• Root/sudo access
• (Optional) NVIDIA GPU + Container Toolkit

Getting Help

• 📖 Check the Troubleshooting guide
• 🔍 Use the sidebar navigation to find specific topics

Repository Structure

/srv/compose/
├── utils/              # Systemd integration and management tools
├── docker/             # Docker configuration and CLI plugins
├── panel/              # Core infrastructure (Traefik, Portainer, Homepage)
├── database/           # Database stack (MongoDB, PostgreSQL, Qdrant)
├── genai/              # AI/ML services (6 services)
│   ├── ollama/
│   ├── openwebui/
│   ├── embedding/
│   ├── librechat/
│   ├── swarmui/
│   └── risuai/
├── plex/               # Plex Media Server + Tautulli
└── stash/              # StashApp media server

License

See repository for license information.

---

Ready to get started? → Quick Start Guide