NetBox
Network source of truth (IPAM/DCIM), built from the upstream NetBox release.
| Port | 8080 |
| Registry | ghcr.io/daemonless/netbox |
| Daemonless | daemonless/netbox |
| Source | netbox-community/netbox |
| Website | netboxlabs.com/oss/netbox |
Needs PostgreSQL 15+ and Redis. Migrations run automatically at start.
Prerequisites
Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions, including the security model for host vs. container privileges.
Deployment
Customize Paths, UID & Ports
Install and manage NetBox on FreeBSD with fjord:
Or open the App Store in the fjord web UI and install NetBox from the wizard. New to fjord? See the Install Guide.
1. Save as .env and fill in what is empty:
2. Save as compose.yaml:
Then run podman-compose up -d.
Save the files above, then run appjail-director up.
Open http://<server>:8080 from another machine (the server's own browser can't use a published port).
Parts
| Service | Image | Role | |
|---|---|---|---|
| netbox | ghcr.io/daemonless/netbox:latest |
docs | |
| postgres | ghcr.io/daemonless/postgres:18 |
docs | |
| redis | ghcr.io/daemonless/redis:latest |
docs |
Parameters
Environment Variables
| Variable | Default | Description |
|---|---|---|
PUID |
1000 |
|
PGID |
1000 |
|
TZ |
UTC |
|
DB_HOST |
127.0.0.1 |
Where NetBox finds PostgreSQL (set automatically for the built-in database; 127.0.0.1 on host networking) |
DB_NAME |
netbox |
PostgreSQL database name |
DB_USER |
netbox |
PostgreSQL user |
DB_PASSWORD |
changeme |
Database password (or DB_PASSWORD_FILE) |
REDIS_HOST |
127.0.0.1 |
Where NetBox finds Redis (set automatically for the built-in Redis; 127.0.0.1 on host networking) |
SUPERUSER_NAME |
admin |
Optional first-run admin user |
SUPERUSER_PASSWORD |
changeme |
Optional first-run admin password |
GRANIAN_WORKERS |
4 |
Granian worker processes (default 2) |
ALLOWED_HOSTS |
`` | Space-separated hostnames (default *) |
CSRF_TRUSTED_ORIGINS |
`` | Space-separated origins, e.g. https://netbox.example.com |
NETBOX_CONFIG_PATH |
/containers/netbox/config |
Path to store NetBox secrets, media and scripts |
DB_DATA_LOCATION |
/containers/netbox/postgres |
Path to store PostgreSQL data files |
NETBOX_SECRET_KEY |
<NETBOX_SECRET_KEY> |
Optional; auto-generated into /config/secret_key |
NETBOX_API_TOKEN_PEPPER |
<NETBOX_API_TOKEN_PEPPER> |
Optional; auto-generated into /config/api_token_pepper |
GRANIAN_* |
`` | Any Granian option via its env var, e.g. GRANIAN_WORKERS_LIFETIME |
Volumes
| Path | Description |
|---|---|
/config |
Secrets, media, scripts, configuration_extra.py |
Ports
| Port | Protocol | Description |
|---|---|---|
8080 |
TCP | Web UI |
Version Tags
| Tag | Description | Best For |
|---|---|---|
latest |
Upstream Binary. Built from official release. | Most users — recommended. |
Implementation Details
- Architectures: amd64
- User:
bsd(UID/GID set via PUID/PGID). Defaults to1000:1000. - Base: Built on
ghcr.io/daemonless/base(FreeBSD 15.1).
Need help? Join our Discord community.