Network source of truth (IPAM/DCIM), built from the upstream NetBox release.
| Port | 8080 |
| Registry | ghcr.io/daemonless/netbox |
| Source | https://github.com/netbox-community/netbox |
| Website | https://netboxlabs.com/oss/netbox/ |
| Tag | Description | Best For |
|---|---|---|
latest |
Upstream Binary. Built from official release. | Most users — recommended. |
| Service | Image | Role | |
|---|---|---|---|
| netbox | ghcr.io/daemonless/netbox:latest |
docs | |
| postgres | ghcr.io/daemonless/postgres:18 |
docs | |
| redis | ghcr.io/daemonless/redis:latest |
docs |
Before deploying, ensure your host environment is ready. See the Quick Start Guide for host setup instructions.
1. Save as .env and fill in what is empty:
# NetBox for FreeBSD (Daemonless)
# Copy to .env and edit.
# Host paths for persistent storage
NETBOX_CONFIG_PATH=/containers/netbox/config
DB_DATA_LOCATION=/containers/netbox/postgres
# Database password and first-run admin (change both before first start)
DB_NAME=netbox
DB_USER=netbox
DB_PASSWORD=changeme
SUPERUSER_NAME=admin
SUPERUSER_PASSWORD=changeme
TZ=UTC2. Save as compose.yaml:
name: netbox
services:
netbox:
image: ghcr.io/daemonless/netbox:latest
container_name: netbox
network_mode: host
depends_on: [postgres, redis]
restart: unless-stopped
environment:
- PUID=1000
- PGID=1000
- TZ=${TZ:-UTC}
- DB_HOST=${DB_HOST:-127.0.0.1}
- DB_NAME=${DB_NAME:-netbox}
- DB_USER=${DB_USER:-netbox}
- DB_PASSWORD=${DB_PASSWORD}
- REDIS_HOST=${REDIS_HOST:-127.0.0.1}
- SUPERUSER_NAME=${SUPERUSER_NAME:-admin}
- SUPERUSER_PASSWORD=${SUPERUSER_PASSWORD}
- GRANIAN_WORKERS=${GRANIAN_WORKERS:-4}
# - GRANIAN_WORKERS_LIFETIME=12h
volumes:
- ${NETBOX_CONFIG_PATH}:/config
ports:
- 8080:8080
postgres:
image: ghcr.io/daemonless/postgres:18
container_name: netbox-postgres
network_mode: host
restart: unless-stopped
annotations:
org.freebsd.jail.allow.sysvipc: "true"
environment:
- POSTGRES_DB=${DB_NAME:-netbox}
- POSTGRES_USER=${DB_USER:-netbox}
- POSTGRES_PASSWORD=${DB_PASSWORD}
volumes:
- ${DB_DATA_LOCATION}:/var/lib/postgresql/data
redis:
image: ghcr.io/daemonless/redis:latest
container_name: netbox-redis
network_mode: host
restart: unless-stoppedThen run podman-compose up -d.
.env:
# .env
DIRECTOR_PROJECT=netbox
PUID=1000
PGID=1000
TZ=UTC
DB_HOST=127.0.0.1
DB_NAME=netbox
DB_USER=netbox
DB_PASSWORD=changeme
REDIS_HOST=127.0.0.1
SUPERUSER_NAME=admin
SUPERUSER_PASSWORD=changeme
GRANIAN_WORKERS=4
NETBOX_CONFIG_PATH=/containers/netbox/config
DB_DATA_LOCATION=/containers/netbox/postgres
appjail-director.yml:
# appjail-director.yml
options:
- alias:
- ip4_inherit:
services:
netbox:
name: netbox
options:
- container: 'args:--pull'
oci:
user: root
environment:
- PUID: !ENV '${PUID}'
- PGID: !ENV '${PGID}'
- TZ: !ENV '${TZ}'
- DB_HOST: !ENV '${DB_HOST}'
- DB_NAME: !ENV '${DB_NAME}'
- DB_USER: !ENV '${DB_USER}'
- DB_PASSWORD: !ENV '${DB_PASSWORD}'
- REDIS_HOST: !ENV '${REDIS_HOST}'
- SUPERUSER_NAME: !ENV '${SUPERUSER_NAME}'
- SUPERUSER_PASSWORD: !ENV '${SUPERUSER_PASSWORD}'
- GRANIAN_WORKERS: !ENV '${GRANIAN_WORKERS}'
- NETBOX_CONFIG_PATH: !ENV '${NETBOX_CONFIG_PATH}'
- DB_DATA_LOCATION: !ENV '${DB_DATA_LOCATION}'
volumes:
- netbox: /config
postgres:
name: postgres
options:
- from: ghcr.io/daemonless/postgres:18
- template: !ENV '${PWD}/postgres-template.conf'
oci:
environment:
- POSTGRES_DB: !ENV '${DB_NAME}'
- POSTGRES_USER: !ENV '${DB_USER}'
- POSTGRES_PASSWORD: !ENV '${DB_PASSWORD}'
volumes:
- db_data: /var/lib/postgresql/data
redis:
name: redis
options:
- from: ghcr.io/daemonless/redis:latest
- template: !ENV '${PWD}/template.conf'
volumes:
netbox:
device: '/containers/netbox'
db_data:
device: !ENV '${DB_DATA_LOCATION}'Makejail:
# Makejail
ARG tag=latest
OPTION container=boot
OPTION overwrite=force
OPTION from=ghcr.io/daemonless/netbox:${tag}
Save the files above, then run appjail-director up.
Warning
Exposing ports in AppJail means that your service can be reached from remote hosts. If that is not your intention, do not expose the ports and communicate with the service using the jail's IPv4 address or hostname assigned by the virtual network.
To avoid exposing ports, just remove the expose option in your appjail-director.yml or from your command-line arguments.
Open http://<server>:8080 from another machine (the server's own browser can't use a published port).
| 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 |
| Path | Description |
|---|---|
/config |
Secrets, media, scripts, configuration_extra.py |
| Port | Protocol | Description |
|---|---|---|
8080 |
TCP | Web UI |
Needs PostgreSQL 15+ and Redis. Migrations run automatically at start.
Architectures: amd64
User: bsd (UID/GID via PUID/PGID, defaults to 1000:1000)
Base: FreeBSD 15.1
Need help? Join our Discord community.