Source Code for the Home Server setup. This includes the git server hosting this repository as well. #terraform #docker
Nemo 452c7d5b79 new user 13 hours ago
abstruse Fix abstruse single image 1 day ago
cloudflare wildcard certs are here!!! 3 weeks ago
digitalocean Make link dependencies explicit 2 months ago
docker new user 13 hours ago
gitea Keep gitea-redis always up 5 days ago
heimdall Adds heimdall 2 months ago
media Removes daapd 5 days ago
monitoring Switch to speedtest:alpine 5 days ago
mysql Adds tt-rss and radarr 2 months ago
radicale Switch to common traefik labels for radicale 2 months ago
resilio resilio added 1 month ago
timemachine terraform file uploads can't be executed 2 weeks ago
tt-rss Switches to common labels for tt-rss 2 months ago
.editorconfig Work on proxying content via sydney 4 months ago
.gitignore Work on proxying content via sydney 4 months ago Removes daapd 5 days ago Adds abstruse CI 2 days ago Adds digital ocean droplet 2 months ago Revert back to sqlite 1 week ago


Nebula header image

Where stars are born.

Manages the local infrastructure of my home server. I'm also doing blog posts around the same:

  1. Part 1, Hardware
  2. Part 2, Terraform/Docker
  3. Part 3, Learnings
  4. Part 4, Migrating from Google (and more)

The canonical URL for this repo is A mirror is maintained on GitHub.


  1. docker: to actually run the services. Catch-all for miscellaneous containers
  2. cloudflare: to manage the DNS.
  3. mysql: to create mysql users and databases.
  4. media: Media related containers (Jackett, Lidarr, Radarr, Sonarr)
  5. Monitoring: Monitoring related resources (Cadvisor, Grafana, NodeExporter, Prometheus, Transmission-Exporter)
  6. Gitea: Just
  7. tt-rss: Tiny-Tiny RSS Web reader
  8. Radicale: CardDav/CalDav webserver

Self-learning project for terraform/docker.


  1. ~Setup DigitalOcean~
  2. Add DO infrastructure via ansible
  3. ~Add traefik for proper proxying~
  4. Maybe add docker swarm (or k8s?) across both the servers. Might setup the k8s API on the Raspberry Pi.

Service List

Currently running the following (all links are to the links for the docker images that I'm using:

image tag size category/module
prom/node-exporter v0.15.2 22.8 monitoring
redis alpine 27.8 gitea
linuxserver/transmission latest 43.9 media
traefik 1.6 51.8 docker
google/cadvisor latest 62.2 monitoring
odarriba/timemachine latest 77.2 backup
gitea/gitea 1.4 77.4 gitea
linuxserver/heimdall latest 101 general
linuxserver/tt-rss latest 108 tt-rss
prom/prometheus latest 113 monitoring
linuxserver/ubooquity latest 114 docker
captn3m0/speedtest-exporter alpine 115 monitoring
tomsquest/docker-radicale latest 130 radicale
linuxserver/lychee latest 154 lychee
linuxserver/resilio-sync latest 167 resilio
emby/embyserver latest 202 media
linuxserver/airsonic latest 239 media
grafana/grafana latest 301 monitoring
requarks/wiki latest 317 wiki
percona/percona-server-mongodb latest 321 wiki
mariadb 10.3 402 db
linuxserver/jackett latest 556 media
linuxserver/sonarr latest 562 media
linuxserver/radarr latest 566 media
linuxserver/lidarr latest 574 media

Docker Notes

  • Lots of the above images are from the excellent, and they're doing great work :+1:
  • Most images are running the latest beta (if available) or stable versions.
  • Traefik is running with wildcard certificates.


Issues I've faced/reported as a result of this project:

  1. Airsonic HTTPS proxying is broken. Reported: Turned out to be a known issue: Now fixed.
  2. Traefik docker backend security headers were broken with dashes. I reported it here, and fixed by :white_check_mark:
  3. Headphones dies repeatedly with no error logs. Yet-to-report. (Already reported, fails due to classical artists)
  4. Terraform doesn't parse mariadb version numbers. Report: Filed a PR to fix and to bump the go-version dependency :white_check_mark:
  5. elibsrv didn't support ebook-convert, only mobigen. PR is at Merged to elibsrv trunk, will be part of next release.
  6. ubooquity docker container doesn't let you set admin password: (Couldn't reproduce, closed) :white_check_mark:
  7. Traefik customresponseheaders can't contain colons on the docker backend: Fixed with :white_check_mark:
  8. Traefik Security headers don't overwrite upstream headers:
  9. Transmission exporter broke with different data types while unmarshalling JSON in go. I filed a PR
  10. Radarr official docker container was running a very old mediainfo. Filed a fix to upgrade mediainfo on the official radarr image
  11. Patched the speedtest-exporter to use Alpine and upgraded Node.JS for a smaller updated build.


Their is a lot of additional infrastructure that is not-yet part of this repo. This includes:

  1. The Digital Ocean droplet running DNSCrypt and simpleproxy to proxy over a openvpn connection to this box.
  2. openbox, kodi configuration to run on boot along with the Steam Controller for the HTPC setup
  3. Docker main configuration with half-baked CA setup
  4. btrfs-backed subvolumes and snapshotting for most things in /mnt/xwing/ (in-progress)
  5. User-creation on the main server. (I'm using a common user for media applications and specific users for other applications)


All code in this repository is shared under the MIT License.