ign8inventory

Provision a production-ready NetBox DCIM/IPAM instance in minutes — Hetzner Cloud VM, Cloudflare DNS, Let's Encrypt TLS, PostgreSQL, and an opinionated default layout, all from a single CLI command.

pip install ign8inventory
ign8inventory setenv   # configure credentials
ign8inventory up       # provision everything
ign8inventory bootstrap  # populate regions, sites, locations

Features

• Single command provisioning — one ign8inventory up creates the Hetzner VM, DNS record, TLS certificate, and a fully configured NetBox instance
• Idempotent — re-running any command is safe; existing resources are detected and reused
• No Terraform, no Ansible — pure Python using the official Hetzner and Cloudflare SDKs
• Database backup — ign8inventory backup exports the PostgreSQL database via SSH and commits it to your repository
• Live server seeding — ign8inventory seed queries your Hetzner projects and upserts running servers into NetBox
• Vault integration — secrets in infrastructure.yml can be stored in and resolved from HashiCorp Vault

Requirements

• Python 3.9+
• A Hetzner Cloud account and API token
• A Cloudflare account managing your domain, with a Zone DNS Edit token

Installation

pipx install ign8inventory   # recommended
# or
pip install ign8inventory

Quickstart

# 1. Configure — writes a .env file with all credentials
ign8inventory setenv

# 2. Provision — Hetzner VM + Cloudflare DNS + TLS + NetBox
ign8inventory up

# 3. Bootstrap — create regions, sites, and availability zones
ign8inventory bootstrap

# 4. Backup — export the database and commit it
ign8inventory backup

Run ign8inventory quickstart for the full step-by-step guide.

Commands

Default layout

ign8inventory bootstrap creates:

• Regions: Europe, North America, Asia Pacific
• Sites: nbg1, fsn1, hel1 (EU) · ash1, hil1 (US) · sin1 (APAC)
• Locations: zone-a, zone-b per site

Environment variables

All variables can also be set via a .env file or passed as CLI flags.

License

MIT