commit b59907d491cce242adbaad77c45772c1ded6b018
Author: ilia <idobkin@gmail.com>
Date:   Sun Dec 28 23:26:12 2025 -0500

    Initial README

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d8110e4
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+# homelab-notes
+
+Personal notes for my homelab: build logs, configs, and operational runbooks for services/VMs/containers I run at home.
+
+## Goals
+
+- Keep **repeatable steps** for installs, upgrades, and troubleshooting.
+- Capture **design decisions** (why something was done a certain way).
+- Document **IPs/ports/paths** used in my environment (may include private network details).
+
+## Repo structure
+
+- Each top-level folder is usually one service or project (e.g. `qBit/`, `vikunja-lxc/`).
+- Notes are primarily Markdown files named like `*-notes.md`.
+
+## How to use
+
+- Read the notes for the service you’re working on.
+- Treat commands as **examples**; adjust hostnames, IPs, and paths to your environment.
+
+## Status
+
+This is an actively evolving notebook. Some sections may be incomplete or “work in progress”.
+
+