Introducing netbox-incus-sync, a NetBox plugin to automatically sync your Incus infrastructure

Hey everyone,

I’ve been working on a NetBox plugin that synchronizes Incus containers and VMs into NetBox and wanted to share it with the community.

What it does:

  • Syncs instances (containers + VMs) as NetBox VirtualMachines with CPU, memory, disk, status, image info
  • Syncs network interfaces, IP addresses, and MAC addresses
  • Maps managed networks to NetBox Prefixes and VLANs (IPAM)
  • Tracks virtual disks with storage pool info and real-time usage stats
  • Full cluster support
  • Multi-project support: each Incus project becomes a NetBox Tenant
  • Syncs profiles as NetBox ConfigContexts
  • Captures VGA console screenshots for VMs (Incus >= 6.7)
  • Logs Incus operations as Journal entries
  • Supports both Unix socket and HTTPS (with multi-URL failover)
  • Stale instance cleanup via UUID tracking

Requires NetBox >= 4.2 and Incus >= 6.0.

Repo: GitHub - Adevixxx/netbox-incus-sync: Incus to NetBox Sync Plugin

Feedback, issues, and contributions are very welcome. I’m using this in production with a small cluster and it’s been working well, but I’d love to hear if others find it useful or run into edge cases.

4 Likes

Nice! Thank you.

1 Like