From d2f5cf7803c488f579ed00d3752121afcafeb14f Mon Sep 17 00:00:00 2001
From: Travis Herbranson <tjherbranson@gmail.com>
Date: Fri, 22 May 2026 16:19:50 -0400
Subject: [PATCH] Migrate it-tools to homelab Traefik; add README

---
 README.md   | 41 +++++++++++++++++++++++++++++++++++++++++
 compose.yml |  4 ++--
 2 files changed, 43 insertions(+), 2 deletions(-)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..7a5b17b
--- /dev/null
+++ b/README.md
@@ -0,0 +1,41 @@
+# it-tools
+
+Self-hosted collection of handy developer / IT utilities
+([corentinth/it-tools](https://github.com/CorentinTh/it-tools)) — encoders,
+converters, generators, formatters, network helpers, etc.
+
+## Access
+
+<https://ittools.herbylab.dev>
+
+## How it's wired
+
+This is a standalone container. It publishes a host port and is fronted by the
+**homelab Traefik VM** — it is *not* routed by Docker labels on this host.
+
+| Piece | Value |
+|---|---|
+| Container port | `80` |
+| Published host port | `8078` |
+| Public hostname | `ittools.herbylab.dev` |
+| TLS | Cloudflare (via the homelab Traefik VM) |
+
+The homelab Traefik VM holds a file-based route at `dynamic/ittools.yml` that
+points `ittools.herbylab.dev` → `http://<dev-host>:8078`. DNS for
+`ittools.herbylab.dev` resolves to the Traefik VM, which proxies to this host.
+
+## Run
+
+```
+docker compose up -d
+```
+
+## Notes
+
+- **No authentication is currently enforced.** Putting it behind Authentik
+  forward-auth (an outpost + `forwardAuth` middleware on the Traefik VM) is a
+  possible follow-up.
+- **History:** migrated 2026-05-21 from the dev box's old local Traefik, where
+  it was served as a `/it-tools` path-prefix on the Tailscale hostname behind
+  Authelia. That local Traefik + Authelia stack was retired in favor of the
+  homelab Traefik VM + Authentik.
diff --git a/compose.yml b/compose.yml
index 65bea0f..d56bfaa 100644
--- a/compose.yml
+++ b/compose.yml
@@ -1,7 +1,7 @@
 services:
-  it-tools:
+  ittools:
     image: corentinth/it-tools:latest
-    container_name: it-tools
+    container_name: ittools
     restart: unless-stopped
     ports:
       - "8078:80"