A collection of sample docker compose files and configurations of popular self hosted for quick reference! Sensible configurations, ports, and folder structures used wherever possible.
- Install Docker.
- Download / Clone the github repo.
cd /opt/
git clone https://github.com/carteakey/server-compose.git- Open the folders of the respective application(s) you want to install.
cd <<your application>>- Replace <parameters> with your values. More details on each application's link and README.md of each folder.
- Spin up the docker image.
docker compose up -d- To stop and remove all containers of the application run:
docker compose down
Alternatively, use the excellent Dockge to manage your stacks.
ℹ️ Check out awesome-selfhosted for an exhaustive list.
| Category | Name | Description | GitHub Repo | Docker Compose Link |
|---|---|---|---|---|
| Dashboard | Homepage by benphelps | A highly customizable homepage (or startpage / application dashboard) with Docker and service API integrations. Sample configurations are present for most of the listed apps. | GitHub | Compose |
| Homarr | Sleek server dashboard with Docker integration and service widgets. | GitHub | Compose | |
| Home Automation | Home Assistant | Open source home automation that puts local control and privacy first. | GitHub | Compose |
| Networking | Traefik | Cloud-native reverse proxy with automatic HTTPS and Docker integration. | GitHub | Compose |
| AdGuard Home | Network-wide DNS ad blocker and privacy protection. | GitHub | Compose | |
| Pi-hole | Network-wide DNS ad blocker (alternative to AdGuard Home). | GitHub | Compose | |
| Identity / SSO | Authentik | Identity provider with SSO, LDAP, SAML, and OIDC support. | GitHub | Compose |
| Media Streaming | Plex Media Server | Centralized home media playback system with a powerful central server. | Compose | |
| Jellyfin | Jellyfin is an alternative to the proprietary Emby and Plex, to provide media from a server to end-user devices via multiple apps. | GitHub | Compose | |
| Navidrome Music Server | Modern Music Server and Streamer, compatible with Subsonic/Airsonic. | GitHub | Compose | |
| TubeArchivist | Your self hosted YouTube media server. | GitHub | Compose | |
| Audiobookshelf | Self-hosted audiobook and podcast server. | GitHub | Compose | |
| Media Downloaders | Transmission-OpenVPN | Run Transmission (Torrent Downloader) only when OpenVPN has an active tunnel. All arr applications will use it to download media. | GitHub | Compose |
| Radarr | Radarr is an independent fork of Sonarr reworked for automatically downloading movies via Usenet and BitTorrent, à la Couchpotato. | GitHub | Compose | |
| Sonarr | Automatic TV Shows downloader and manager for Usenet and BitTorrent. | GitHub | Compose | |
| Lidarr-on-steroids | A modded version of Lidarr with Native Deemix integration as an indexer and downloader for Lidarr. | GitHub | Compose | |
| Prowlarr | Indexer manager/proxy built on the popular arr stack to integrate with your PVR apps. | GitHub | Compose | |
| Bazarr | Companion application to Sonarr and Radarr that manages and downloads subtitles. | GitHub | Compose | |
| Deemix | Barebone deezer downloader library. | Compose | ||
| Overseerr | Request management and media discovery tool for Plex ecosystem. | GitHub | Compose | |
| File Sharing & Backup | Immich | High performance self-hosted photo and video backup solution. | GitHub | Compose |
| Nextcloud | A safe home for all your data. Access & share your files, calendars, contacts, mail & more from any device, on your terms. | GitHub | Compose | |
| Paperless-ngx | Paperless-ngx is a document management system that transforms your physical documents into a searchable online archive so you can keep, well, less paper. | GitHub | Compose | |
| Password Management | Vaultwarden | Lightweight Bitwarden-compatible password manager server. | GitHub | Compose |
| Container Management | Portainer | Lightweight management UI for Docker containers. | GitHub | Compose |
| WatchTower | Automates Docker container base image updates. | GitHub | Compose | |
| Dockge | A fancy, easy-to-use and reactive self-hosted docker compose.yaml stack-oriented manager. | GitHub | Compose | |
| Tools | Epic Games Store Weekly Free Games | Automatically redeem promotional free games from the Epic Games Store. | GitHub | Compose |
| pyLoad | Free & Open Source lightweight download manager written in Python. | GitHub | Compose | |
| changedetection.io | Web Site Change Detection and notifications. | GitHub | Compose | |
| FileFlows | Fileflows lets you process files through a simple rule flow. | GitHub | Compose | |
| Stirling PDF | Self-hosted PDF manipulation tool (merge, split, convert, OCR). | GitHub | Compose | |
| IT Tools | Collection of handy developer utilities (hash generators, encoders, etc). | GitHub | Compose | |
| SearXNG | Privacy-respecting meta search engine aggregating 70+ sources. | GitHub | Compose | |
| Finance | Firefly III | "Firefly III" is a (self-hosted) manager for your personal finances. | GitHub | Compose |
| Actual Budget | Actual Budget is a super fast and privacy-focused app for managing your finances. | GitHub | Compose | |
| Server Monitoring | cAdvisor | Analyzes resource usage and performance of running docker containers. | GitHub | Compose |
| Prometheus | Open-source monitoring system. | GitHub | Compose | |
| node-exporter | Exposes hardware- and kernel-related metrics. | GitHub | Compose | |
| Grafana | Multi-platform open source analytics and interactive visualization web application. | GitHub | Compose | |
| Scrutiny | WebUI for smartd S.M.A.R.T monitoring. | GitHub | Compose | |
| Uptime Kuma | Lightweight and fancy self-hosted monitoring tool. | GitHub | Compose | |
| Speedtest Tracker | Automated internet speed test scheduling with historical graphs. | GitHub | Compose | |
| AI / LLM | Ollama + Open WebUI | Local LLM inference with a ChatGPT-style web interface. | GitHub | Compose |
| Dev Tools | Gitea | Lightweight self-hosted Git service (GitHub/GitLab alternative). | GitHub | Compose |
| Recipes | Tandoor Recipes | Recipe manager and meal planner for your household. | GitHub | Compose |
| Mealie | Intuitive recipe manager with meal planning and recipe scraping. | GitHub | Compose | |
| Books | Calibre-Web | Web-based ebook management and reader powered by Calibre. | GitHub | Compose |
| RSS | FreshRSS | Self-hosted RSS feed aggregator, lightweight and customizable. | GitHub | Compose |
| Notifications | ntfy | Simple push notification service with HTTP API (UnifiedPush). | GitHub | Compose |
| Automation | n8n | Workflow automation tool (Zapier/Make alternative) with 400+ integrations. | GitHub | Compose |
| Passive Income / Bandwidth Sharing | HoneyGain | Make money by sharing your Internet. | Compose | |
| EarnApp | Earn passive income while your devices rest. | Compose | ||
| PawnsApp | Make passive money online by sharing your internet. | Compose |
The included update-compose.sh script can automatically fetch the latest docker-compose.yml files from each service's upstream repository.
Prerequisites: bash, curl, diff (all standard on Linux).
# Interactive mode — review and approve each change
./update-compose.sh -i
# Pull latest compose files for all services (shows summary only)
./update-compose.sh
# Show full diffs of what changed
./update-compose.sh --verbose
# Preview changes without modifying any files
./update-compose.sh --dry-run
# Update only a single service
./update-compose.sh --service immich --verbose
# Pull + restart changed containers
./update-compose.sh --applyAdd an entry to services.yaml:
my-service:
source_type: github_raw # or github_release or url
repo: owner/repo
branch: main
path: docker-compose.ymlMany services default to the same host ports (e.g. 8080). The included check-ports.sh script scans all compose files and reports conflicts.
# Check for port conflicts
./check-ports.sh
# Auto-resolve by reassigning duplicate host ports
./check-ports.sh --fix- List will continue to grow, but will try to not be overwhelming.
- Individual README files for each compose.
- Website (Maybe).
Feel free to open a pull request and add your favorite apps.