Prerequisites

Installation Journey

Prerequisites (you are here) → Quickstart or Standard Install

Before installing NetBox Enterprise with the netbox-enterprise Helm chart, verify your environment meets these requirements.

Kubernetes Version

Kubernetes 1.26 or later is required.

kubectl version

Required Tools

Tool	Minimum Version	Purpose
Helm	3.x	Chart installation and management
kubectl	Matching cluster version	Cluster interaction and debugging

Resource Requirements

Cluster Sizing

Environment	vCPU	Memory (RAM)	Disk Space
Production (recommended)	8 vCPU	24 GB	100 GB SSD
Non-production (minimum)	4 vCPU	16 GB	50 GB SSD

These recommendations account for the full stack: operator, NetBox application, workers, PostgreSQL, Redis, and Diode components. SSD or NVMe storage is recommended for database performance.

Per-Component Defaults

Component	CPU Request	Memory Request	CPU Limit	Memory Limit
Operator	100m	128Mi	500m	512Mi
NetBox app (per replica)	200m	750Mi	1000m	1500Mi
NetBox worker (per replica)	100m	128Mi	1000m	1500Mi
PostgreSQL (PGO-managed)	-	-	-	-
Redis	250m	256Mi	-	-

warning

The per-component defaults are conservative requests to allow scheduling. For production workloads, ensure your nodes have sufficient headroom above these minimums.

Registry Access

NetBox Enterprise images are hosted on the registry at registry.enterprise.netboxlabs.com. You need valid license credentials (your email and license ID) to authenticate before installing.

Chart Dependencies

The netbox-enterprise chart automatically installs these dependencies (can be disabled individually):

Dependency	Version	Purpose	Toggle
PGO (Crunchy Postgres Operator)	6.0.0	Manages internal PostgreSQL	pgo.enabled
Redis Operator	0.22.2	Manages internal Redis	redis-operator.enabled
Replicated SDK	1.11.2	License management	replicated.enabled

info

When using an external PostgreSQL database, you can disable PGO with pgo.enabled: false. Similarly, set redis-operator.enabled: false when using external Redis.

RBAC Requirements

The operator requires cluster-level or namespace-level RBAC permissions depending on the rbac.scope setting:

• cluster (default): Creates ClusterRole and ClusterRoleBinding. The operator watches for NetBoxEnterprise resources across all namespaces.
• namespace: Creates Role and RoleBinding in the release namespace only.

Persistent Storage

The cluster must have a default StorageClass or you must specify one explicitly. Storage is used for:

• PostgreSQL data (default: 4Gi)
• NetBox media files (default: 10Gi)
• NetBox scripts (default: 1Gi)
• Redis persistence (if enabled)

Next Steps

• Quickstart — Get running in 5 minutes with minimal configuration
• Standard Installation — Full installation with custom values