Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/IsaiasCarrion/Homelab/llms.txt

Use this file to discover all available pages before exploring further.

The inventory/ directory is the single source of truth for everything that is running — or reserved — in the homelab network. Four Markdown files collectively track every host and its IP address, every deployed service and its URL, every DNS record in Technitium, and every port allocation across the infrastructure. Keeping these files accurate makes troubleshooting, onboarding, and capacity planning dramatically faster.

Inventory Files

FileContents
inventory/hosts.mdAll hosts and their assigned IP addresses
inventory/services.mdDeployed services, URLs, and current status
inventory/dns.mdInternal DNS records managed by Technitium
inventory/ports.mdPort allocations across all hosts and containers

Host Inventory Summary

The following hosts make up the core infrastructure of the homelab, all residing on the 192.168.1.0/24 network under the home.arpa local domain:
HostTypeIP AddressHostname
Proxmox VEHypervisor192.168.1.20pve.home.arpa
Technitium DNSLXC192.168.1.21dns.home.arpa
Nginx Proxy ManagerLXC192.168.1.22npm.home.arpa
TailscaleLXC192.168.1.23ts.home.arpa
Docker VMVM192.168.1.30docker.home.arpa
HomelableLXC192.168.1.103homelable.home.arpa
Static IP addresses are reserved in the router for all infrastructure nodes. The DHCP range (192.168.1.100–254) is separate from the statically assigned infrastructure ranges (192.168.1.20–99), so adding a new host will not conflict with existing reservations as long as it is assigned an address in the appropriate subnet segment.

Services Inventory Summary

The table below reflects the current state of all deployed and in-progress services. Services marked 🚧 are planned or partially deployed and not yet production-ready within the homelab.
ServiceURLFunctionStatus
Portainerportainer.home.arpaDocker management
Dashydashy.home.arpaDashboard
Speedtest Trackerspeed.home.arpaISP monitoring
Technitium DNSdns.home.arpaDNS + Adblock
Nginx Proxy Managernpm.home.arpaReverse Proxy
Homelablehomelable.home.arpaNetwork map
Grafanagrafana.home.arpaObservability🚧
Prometheusprometheus.home.arpaMetrics🚧
Giteagit.home.arpaGit self-hosted🚧
All active services are reachable via their home.arpa hostnames thanks to Technitium DNS handling internal resolution and Nginx Proxy Manager terminating SSL and routing traffic to the appropriate containers on the Docker VM.

Updating the Inventory

When hosts are added, removed, or reassigned in Proxmox, run the update_hosts.sh script from the scripts/ directory to regenerate the inventory files automatically:
bash scripts/update_hosts.sh
This keeps inventory/hosts.md (and related files) in sync with the actual state of the network without requiring manual edits to each file individually.
Treat the inventory files as living documentation — update them every time a new service is deployed or decommissioned. An accurate inventory makes it far easier to diagnose port conflicts, track down a service by IP, or hand off the lab to someone else. The update_hosts.sh script handles hosts, but inventory/services.md, inventory/dns.md, and inventory/ports.md should be reviewed manually after each infrastructure change.

Build docs developers (and LLMs) love