server-compose

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.

How to Use

• 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.

Applications

ℹ️ 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

Auto-Update Compose Files

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).

Quick Start

# 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 --apply

Adding a New Service

Add an entry to services.yaml:

  my-service:
    source_type: github_raw      # or github_release or url
    repo: owner/repo
    branch: main
    path: docker-compose.yml

Port Conflict Checker

Many 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

Roadmap

• List will continue to grow, but will try to not be overwhelming.
• Individual README files for each compose.
• Website (Maybe).

Contribution.

Feel free to open a pull request and add your favorite apps.