Ben's HomeLab

🧩 Docker Logging + Reverse Proxy Stack

This project sets up a multi-service Docker stack with the following features:

✅ Centralized logging system using a log-watcher sidecar container
✅ Clean, timestamped logs saved per service in /logs/*.log
✅ NGINX reverse proxy with virtual hosts like flexget.localhost
✅ Fully configurable services list via a single JSON file
✅ Clean project structure with all logs and scripts inside the logs/ directory

🚀 Stack Overview

Services included:

bazarr (subtitle downloader)
flexget (download automation)
log-watch (sidecar for logging)
nzbget (usenet downloader)
nginx (reverse proxy)
overseerr (media request management)
plex (media server)
portainer (container management)
prowlarr (indexer for Radarr/Sonarr)
radarr (movie downloader)
readarr (ebook downloader)
sonarr (TV show downloader)
transmission (torrent downloader)
upsnap (WOL service)

Those services aim to automate media management by handling downloads, organization and streaming. Remote operations with Upsnap ensures to be able to power any device from Home anywhere else.

🛠️ Setup

1. 📌 Clone the project

git clone <this-repo>
cd <project-folder>

2. 📌 Hosts Configuration for Reverse Proxy

To make the reverse proxy work correctly using custom service domains like flexget.localhost, you must configure your system's hosts file. This step is required to map fake local domains to your local machine or server.

🧠 Why it matters

The reverse proxy uses domain-based routing (server_name) to send traffic to the right Docker service. Without hosts entries, your system won't know where to send requests like http://upsnap.localhost.

🛠️ Configuration Instructions

Everything is currently set as a localhost but if you need to configure your custom server ip address, feel free to do so.

✅ Linux / macOS

Edit /etc/hosts and append the following lines:

127.0.0.1 flexget.localhost
127.0.0.1 upsnap.localhost
127.0.0.1 portainer.localhost
127.0.0.1 transmission.localhost
127.0.0.1 nzbget.localhost
127.0.0.1 nginx.localhost

Automated hosts update, make sure to place a copy of your hosts file onto HL/docker/assets, launch the docker compose (up), once it is updated you can replace the old one from /etc/hosts.

✅ Windows

Edit C:\Windows\System32\drivers\etc\hosts and append the following lines:

127.0.0.1 flexget.localhost
127.0.0.1 upsnap.localhost
127.0.0.1 portainer.localhost
127.0.0.1 transmission.localhost
127.0.0.1 nzbget.localhost
127.0.0.1 nginx.localhost

Automated hosts update, make sure to place a copy of your hosts file onto HL/docker/assets, launch the docker compose (up), once it is updated you can replace the old one from C:\Windows\System32\drivers\etc\hosts.

Then empty the Windows DNS cache : ipconfig /flushdns

If it still doesn't work, try to test a ping onto the desired domain names.

Aladdine95/HomeLab

ErrorLooks like something went wrong!

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages