Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 15 additions & 9 deletions readme-vars.yml
Original file line number Diff line number Diff line change
Expand Up @@ -21,25 +21,30 @@ param_volumes:
- { vol_path: "/config", vol_host_path: "<path to data on host>", desc: "config directory volume mapping" }
param_usage_include_env: true
param_env_vars:
- { env_var: "TZ", env_value: "<TZ>", desc: "Timezone (i.e., America/New_York)" }
- { env_var: "SUPERUSER_EMAIL", env_value: "<SUPERUSER_EMAIL>", desc: "Email address for `admin` account" }
- { env_var: "SUPERUSER_PASSWORD", env_value: "<SUPERUSER_PASSWORD>", desc: "Password for `admin` account" }
- { env_var: "ALLOWED_HOST", env_value: "<ALLOWED_HOST>", desc: "The hostname you will use to access the app (i.e., netbox.example.com)" }
- { env_var: "BASE_PATH", env_value: "<BASE_PATH>", desc: "The path you will use to access the app (i.e., /netbox, optional, default: none)" }
- { env_var: "DB_NAME", env_value: "<DB_NAME>", desc: "Database name (optional, default: netbox)" }
- { env_var: "DB_NAME", env_value: "<DB_NAME>", desc: "Database name (default: netbox)" }
- { env_var: "DB_USER", env_value: "<DB_USER>", desc: "Database user" }
- { env_var: "DB_PASSWORD", env_value: "<DB_PASSWORD>", desc: "Database password" }
- { env_var: "DB_HOST", env_value: "<DB_HOST>", desc: "Database host (optional, default: postgres)" }
- { env_var: "DB_PORT", env_value: "<DB_PORT>", desc: "Database port (optional)" }
- { env_var: "REDIS_HOST", env_value: "<REDIS_HOST>", desc: "Redis host (optional, default: redis)" }
- { env_var: "REDIS_PORT", env_value: "<REDIS_PORT>", desc: "Redis port number (optional, default: 6379)" }
- { env_var: "REDIS_PASSWORD", env_value: "<REDIS_PASSWORD>", desc: "Redis password (optional, default: none)" }
- { env_var: "DB_HOST", env_value: "<DB_HOST>", desc: "Database host (default: postgres)" }
- { env_var: "DB_PORT", env_value: "<DB_PORT>", desc: "Database port (defaul: 5432)" }
- { env_var: "REDIS_HOST", env_value: "<REDIS_HOST>", desc: "Redis host (default: redis)" }
- { env_var: "REDIS_PORT", env_value: "<REDIS_PORT>", desc: "Redis port number (default: 6379)" }
- { env_var: "REDIS_PASSWORD", env_value: "<REDIS_PASSWORD>", desc: "Redis password (default: none)" }
- { env_var: "REDIS_DB_TASK", env_value: "<REDIS_DB_TASK>", desc: "Redis database ID for tasks (default: 0)" }
- { env_var: "REDIS_DB_CACHE", env_value: "<REDIS_DB_CACHE>", desc: "Redis database ID for caching (default: 1)" }

opt_param_usage_include_env: true
opt_param_env_vars:
- { env_var: "BASE_PATH", env_value: "<BASE_PATH>", desc: "The path you will use to access the app (i.e., /netbox, optional, default: none)" }
- { env_var: "REMOTE_AUTH_ENABLED", env_value: "<REMOTE_AUTH_ENABLED>", desc: "Enable remote authentication (optional, default: False)" }
- { env_var: "REMOTE_AUTH_BACKEND", env_value: "<REMOTE_AUTH_BACKEND>", desc: "Python path to the custom Django authentication backend to use for external user authentication (optional, default: netbox.authentication.RemoteUserBackend)" }
- { env_var: "REMOTE_AUTH_HEADER", env_value: "<REMOTE_AUTH_HEADER>", desc: "Name of the HTTP header which informs NetBox of the currently authenticated user. (optional, default: HTTP_REMOTE_USER)" }
- { env_var: "REMOTE_AUTH_AUTO_CREATE_USER", env_value: "<REMOTE_AUTH_AUTO_CREATE_USER>", desc: "If true, NetBox will automatically create local accounts for users authenticated via a remote service (optional, default: False)" }
- { env_var: "REMOTE_AUTH_DEFAULT_GROUPS", env_value: "<REMOTE_AUTH_DEFAULT_GROUPS>", desc: "The list of groups to assign a new user account when created using remote authentication (optional, default: [])" }
- { env_var: "REMOTE_AUTH_DEFAULT_PERMISSIONS", env_value: "<REMOTE_AUTH_DEFAULT_PERMISSIONS>", desc: "A mapping of permissions to assign a new user account when created using remote authentication (optional, default: {})" }
- { env_var: "TZ", env_value: "<TZ>", desc: "Timezone (i.e., America/New_York)" }

param_usage_include_ports: true
param_ports:
Expand All @@ -48,12 +53,13 @@ param_ports:
# application setup block
app_setup_block_enabled: true
app_setup_block: |
Netbox requires a postgres database.
Netbox requires a postgres database and a redis instance.

Access the WebUI at <your-ip>:8000. For more information, check out [NetBox](https://github.com/netbox-community/netbox).

# changelog
changelogs:
- { date: "26.04.21:", desc: "Added Redis database environment variables." }
- { date: "03.02.21:", desc: "Added remote authentication environment variables." }
- { date: "02.01.21:", desc: "Added BASE_PATH environment variable." }
- { date: "23.08.20:", desc: "Initial Release." }
4 changes: 2 additions & 2 deletions root/defaults/configuration.py
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@
# 'SENTINELS': [('mysentinel.redis.example.com', 6379)],
# 'SENTINEL_SERVICE': 'netbox',
'PASSWORD': '{{REDIS_PASSWORD}}',
'DATABASE': 0,
'DATABASE': {{REDIS_DB_TASK}},
'DEFAULT_TIMEOUT': 300,
'SSL': False,
},
Expand All @@ -43,7 +43,7 @@
# 'SENTINELS': [('mysentinel.redis.example.com', 6379)],
# 'SENTINEL_SERVICE': 'netbox',
'PASSWORD': '{{REDIS_PASSWORD}}',
'DATABASE': 1,
'DATABASE': {{REDIS_DB_CACHE}},
'DEFAULT_TIMEOUT': 300,
'SSL': False,
}
Expand Down
2 changes: 2 additions & 0 deletions root/etc/cont-init.d/50-config
Original file line number Diff line number Diff line change
Expand Up @@ -13,6 +13,8 @@ NETBOX_CONF[DB_PORT]=${DB_PORT:-}
NETBOX_CONF[REDIS_HOST]=${REDIS_HOST:-redis}
NETBOX_CONF[REDIS_PORT]=${REDIS_PORT:-6379}
NETBOX_CONF[REDIS_PASSWORD]=${REDIS_PASSWORD:-}
NETBOX_CONF[REDIS_DB_TASK]=${REDIS_DB_TASK:-0}
NETBOX_CONF[REDIS_DB_CACHE]=${REDIS_DB_CACHE:-1}
NETBOX_CONF[REMOTE_AUTH_ENABLED]=${REMOTE_AUTH_ENABLED:-False}
NETBOX_CONF[REMOTE_AUTH_BACKEND]=${REMOTE_AUTH_BACKEND:-netbox.authentication.RemoteUserBackend}
NETBOX_CONF[REMOTE_AUTH_HEADER]=${REMOTE_AUTH_HEADER:-HTTP_REMOTE_USER}
Expand Down