Skip to content
Docker media and home server stack with Docker Compose, Traefik, Swarm Mode, Google OAuth2, and LetsEncrypt
Branch: master
Clone or download
Latest commit 53288fa Jan 14, 2020
Type Name Latest commit message Commit time
Failed to load latest commit information.
picard updates Nov 13, 2019
shared some updates Nov 7, 2019
traefik1 updates Jan 6, 2020
traefik2/rules updates Dec 16, 2019
.bash_aliases.example updates Jan 6, 2020
.env.example updates Nov 8, 2019
.gitignore updates Jan 6, 2020 updates Jan 15, 2020
LICENSE Initial commit Nov 7, 2019 updates Jan 14, 2020
docker-compose-t1-obsolete.yml updates Jan 10, 2020
docker-compose-t1-swarm.yml updates Jan 6, 2020
docker-compose-t1-vpn.yml updates Jan 14, 2020
docker-compose-t1.yml updates Jan 15, 2020
docker-compose-t2-obsolete.yml updates Jan 10, 2020
docker-compose-t2-vpn.yml updates Jan 14, 2020
docker-compose-t2.yml updates Jan 14, 2020


This is the updated docker-compose repo of all the media and home server apps described in the following guides on our website:

A Note on Traefik 1 vs Traefik 2?

Update (December 16, 2019): First draft of Traefik 2.1 setup pushed to the repository. At this point, it works for most of the apps. Still a lot to be figured out and optimized. Look for a detailed guide on our website in the coming days.

Traefik 1

  • docker-compose-t1.yml
  • docker-compose-t1-vpn.yml
  • docker-compose-t1-obsolete.yml (Apps that we do not use anymore)

Traefik 1 - Docker Swarm Mode

  • docker-compose-t1-swarm.yml

Traefik 2

  • docker-compose-t2.yml
  • docker-compose-t2-vpn.yml
  • docker-compose-t2-obsolete.yml (Apps that we do not use anymore)

At this point we still prefer Traefik 1. As we move ours to Traefik 2, we will publish a new repository.

Having said that, Traefik 1.7.16 (the final release in v1.x.x) still works great for the purposes of a media / home server stack. Traefik 2 is significantly different requiring a major rework of your files. Therefore, if you are already on Traefik 1, we do not see a need to upgrade to Traefik 2 at this point.

If you are starting out, you may start with Traefik 2. However, documentation, community knowledge, and support for Traefik 2 is still quite limited at this time.

What apps are included in this stack?

We will try to keep this repo up-to-date. For now, here are the apps currently included in our stack:


  • Traefik - Reverse Proxy
  • OAuth - Forward Authentication
  • Portainer - Container Management
  • Organizr - Unified Frontend
  • Heimdall - Unified Frontend Alternative
  • Autoindex - Plain text Index to All Files


  • HA-Dockermon - Manage Docker containers in Home Assistant
  • Mosquitto - MQTT Broker
  • ZoneMinder - Video Surveillance
  • MiFlora - MiFlora MQTT Daemon (MiFlora Plant Sensors)


  • phpMyAdmin - Database management
  • MariaDB - MySQL Database
  • InfluxDB - Database for sensor data
  • Postgres - Database
  • Grafana - Graphical data visualization for InfluxDB data
  • Varken - Monitor Plex, Sonarr, Radarr, and Other Data (OBSOLETE)


  • jDownloader - Download management
  • SABnzbd - Binary newsgrabber (NZB downloader)
  • qBittorrent - Torrent downloader
  • TransmissionBT - Torrent Downloader


  • Jackett - Torrent proxy
  • NZBHydra2 - NZB meta search


  • Lidarr - Music Management
  • Radarr - Movie management
  • Sonarr - TV Shows management


  • AirSonic - Music Server
  • Plex - Media Server
  • Jellyfin - Media Server
  • Emby - Media Server (OBSOLETE)
  • Tautulli - Previously PlexPy. Plex statistics and monitoring
  • Plex-Sync - For Syncing watched status between plex servers
  • TellyTv- IPTV proxy for Plex (OBSOLETE)
  • xTeve- IPTV proxy for Plex


  • Bazarr - Subtitle Management
  • Picard - Music Library Tagging and Management
  • Handbrake - Video Conversion (Transcoding and compression)
  • MKVToolNix - Video Editing (Remuxing - changing media container while keeping original source quality)
  • MakeMKV - Video Editing (Ripping from Disks)
  • FileBot - File renamer


  • Firefox - Web Broswer
  • Glances - System Information
  • Logarr - Log Management
  • Monitorr - Webfront to display the status of any webapp or service (OBSOLETE)
  • APCUPSD - APC UPS Management
  • qDirStat - Directory Statistics
  • Guacamole - Remote desktop, SSH, on Telnet on any HTML5 Browser
  • Guacamole Daemon - Needed for Guacamole
  • StatPing - Status Page & Monitoring Server


  • Ouroboros - Automatic Docker Container Updates
  • Docker-GC - Automatic Docker Garbage Collection

IPVanish VPN

Some of the containers are behind VPN for privacy and security. We have been using IPVanish for a while now. The following apps are behind IPVanish VPN:

  • Jackett
  • qBittorrent
  • Transmission BT
  • jDownloader

Based on the docker-compose blocks for the above apps, you can almost any of the apps behind VPN.


Some of the containers in docker-compose.yml (eg. ZoneMinder, Guacamole, phpMyAdmin, etc.) need MariaDB. At this point, an external MariaDB host is specified, with the assumption that you have MariaDB running elsewhere (eg. on your NAS).

At some point, we will add a MariaDB container and use that as the database host.



First, install Docker and Docker Compose, as described in our Docker Media Server guide.

  1. Clone the repo.
  2. Configure traefik.toml
  • Rename traefik\traefik.toml.example to traefik\traefik.toml
  • Edit it to reflect your situation
  • Edit domain name.
  • DNS Challenge (for LetsEncrypt verification) is enabled by default for cloudflare. Use the Traefik Reverse Proxy guide for help with this.
  • For other providers other than cloudflare, check here.
  1. (Optional) Enable or use HTTP Basic Authentication by renaming shared\.htpasswd.example to shared\.htpasswd in the folder and adding username and hashed password to it.
  2. Configure environmental variables (.env file)
  • Rename the included .env.example to .env.
  • Edit variables in .env file.
  • All variables (ie. ${XXX}) in docker-compose.yml come from .env file stored in the same place as docker-compose.yml.
  • Ensure good permissions for the .env file (recommended: 640).
  1. Edit docker-compose.yml to include only the services you want or add additional services to it. Be sure to read the comments for each app and create any required files.
  2. Start and stop your docker stack as described in our Docker Media Server guide.
  3. (Optional) Put non-docker apps behind Traefik proxy by renaming traefik\rules\app.toml.example to traefik\rules\app.toml and editing its contents.

Starting and Stopping

I use bash_aliases to simplify starting and stopping containers/stack. Included in the repo is an example of bash_aliases I use (replace USER with your Linux username). Here are some example alias commands:

  • dc1up or dc2up - Create network and start Docker Traefik 1 or 2 stack
  • dc1down or dc2down - Stop Docker Traefik 1 or 2 stack
  • dcup1 or dcup2 - Start Docker Traefik 1 or 2 stack
  • dcup1v or dcup2v - Start Docker Trafik 1 or 2 VPN stack
  • dcdown1 or dcdown2 - Stop Docker Traefik 1 or 2 stack
  • dcdown1v or dcdown2v - Stop Docker Traefik 1 or 2 VPN stack
  • dcrec1 or dcrec2 - Start or recreate a specific service
  • dcstop1 or dcstop2 - Stop a specific service
  • dcrestart1 or dcrestart2 - Restart a specific service
  • dclogs1 or dclogs1v or dclogs2 or dclogs2v - See real-time logs for the corresponding stack or service
  • dcpull1 or dcpull1v or dcpull2 or dcpull2v - Pull new images for the corresponding stack or service
You can’t perform that action at this time.