@@ -59,7 +59,7 @@ The architectures supported by this image are:
5959
6060## Application Setup
6161
62- Netbox requires a postgres database.
62+ Netbox requires a postgres database and a redis instance .
6363
6464Access the WebUI at <your-ip >:8000. For more information, check out [ NetBox] ( https://github.com/netbox-community/netbox ) .
6565
@@ -81,10 +81,10 @@ services:
8181 environment :
8282 - PUID=1000
8383 - PGID=1000
84+ - TZ=<TZ>
8485 - SUPERUSER_EMAIL=<SUPERUSER_EMAIL>
8586 - SUPERUSER_PASSWORD=<SUPERUSER_PASSWORD>
8687 - ALLOWED_HOST=<ALLOWED_HOST>
87- - BASE_PATH=<BASE_PATH>
8888 - DB_NAME=<DB_NAME>
8989 - DB_USER=<DB_USER>
9090 - DB_PASSWORD=<DB_PASSWORD>
@@ -93,13 +93,15 @@ services:
9393 - REDIS_HOST=<REDIS_HOST>
9494 - REDIS_PORT=<REDIS_PORT>
9595 - REDIS_PASSWORD=<REDIS_PASSWORD>
96- - REMOTE_AUTH_ENABLED=<REMOTE_AUTH_ENABLED>
97- - REMOTE_AUTH_BACKEND=<REMOTE_AUTH_BACKEND>
98- - REMOTE_AUTH_HEADER=<REMOTE_AUTH_HEADER>
99- - REMOTE_AUTH_AUTO_CREATE_USER=<REMOTE_AUTH_AUTO_CREATE_USER>
100- - REMOTE_AUTH_DEFAULT_GROUPS=<REMOTE_AUTH_DEFAULT_GROUPS>
101- - REMOTE_AUTH_DEFAULT_PERMISSIONS=<REMOTE_AUTH_DEFAULT_PERMISSIONS>
102- - TZ=<TZ>
96+ - REDIS_DB_TASK=<REDIS_DB_TASK>
97+ - REDIS_DB_CACHE=<REDIS_DB_CACHE>
98+ - BASE_PATH=<BASE_PATH> # optional
99+ - REMOTE_AUTH_ENABLED=<REMOTE_AUTH_ENABLED> # optional
100+ - REMOTE_AUTH_BACKEND=<REMOTE_AUTH_BACKEND> # optional
101+ - REMOTE_AUTH_HEADER=<REMOTE_AUTH_HEADER> # optional
102+ - REMOTE_AUTH_AUTO_CREATE_USER=<REMOTE_AUTH_AUTO_CREATE_USER> # optional
103+ - REMOTE_AUTH_DEFAULT_GROUPS=<REMOTE_AUTH_DEFAULT_GROUPS> # optional
104+ - REMOTE_AUTH_DEFAULT_PERMISSIONS=<REMOTE_AUTH_DEFAULT_PERMISSIONS> # optional
103105 volumes :
104106 - <path to data on host>:/config
105107 ports :
@@ -114,10 +116,10 @@ docker run -d \
114116 --name=netbox \
115117 -e PUID=1000 \
116118 -e PGID=1000 \
119+ -e TZ=<TZ> \
117120 -e SUPERUSER_EMAIL=<SUPERUSER_EMAIL> \
118121 -e SUPERUSER_PASSWORD=<SUPERUSER_PASSWORD> \
119122 -e ALLOWED_HOST=<ALLOWED_HOST> \
120- -e BASE_PATH=<BASE_PATH> \
121123 -e DB_NAME=<DB_NAME> \
122124 -e DB_USER=<DB_USER> \
123125 -e DB_PASSWORD=<DB_PASSWORD> \
@@ -126,13 +128,15 @@ docker run -d \
126128 -e REDIS_HOST=<REDIS_HOST> \
127129 -e REDIS_PORT=<REDIS_PORT> \
128130 -e REDIS_PASSWORD=<REDIS_PASSWORD> \
129- -e REMOTE_AUTH_ENABLED=<REMOTE_AUTH_ENABLED> \
130- -e REMOTE_AUTH_BACKEND=<REMOTE_AUTH_BACKEND> \
131- -e REMOTE_AUTH_HEADER=<REMOTE_AUTH_HEADER> \
132- -e REMOTE_AUTH_AUTO_CREATE_USER=<REMOTE_AUTH_AUTO_CREATE_USER> \
133- -e REMOTE_AUTH_DEFAULT_GROUPS=<REMOTE_AUTH_DEFAULT_GROUPS> \
134- -e REMOTE_AUTH_DEFAULT_PERMISSIONS=<REMOTE_AUTH_DEFAULT_PERMISSIONS> \
135- -e TZ=<TZ> \
131+ -e REDIS_DB_TASK=<REDIS_DB_TASK> \
132+ -e REDIS_DB_CACHE=<REDIS_DB_CACHE> \
133+ -e BASE_PATH=<BASE_PATH> `#optional` \
134+ -e REMOTE_AUTH_ENABLED=<REMOTE_AUTH_ENABLED> `#optional` \
135+ -e REMOTE_AUTH_BACKEND=<REMOTE_AUTH_BACKEND> `#optional` \
136+ -e REMOTE_AUTH_HEADER=<REMOTE_AUTH_HEADER> `#optional` \
137+ -e REMOTE_AUTH_AUTO_CREATE_USER=<REMOTE_AUTH_AUTO_CREATE_USER> `#optional` \
138+ -e REMOTE_AUTH_DEFAULT_GROUPS=<REMOTE_AUTH_DEFAULT_GROUPS> `#optional` \
139+ -e REMOTE_AUTH_DEFAULT_PERMISSIONS=<REMOTE_AUTH_DEFAULT_PERMISSIONS> `#optional` \
136140 -p 8000:8000 \
137141 -v <path to data on host>:/config \
138142 --restart unless-stopped \
@@ -148,25 +152,27 @@ Container images are configured using parameters passed at runtime (such as thos
148152| ` -p 8000 ` | will map the container's port 8000 to port 8000 on the host |
149153| ` -e PUID=1000 ` | for UserID - see below for explanation |
150154| ` -e PGID=1000 ` | for GroupID - see below for explanation |
155+ | ` -e TZ=<TZ> ` | Timezone (i.e., America/New_York) |
151156| ` -e SUPERUSER_EMAIL=<SUPERUSER_EMAIL> ` | Email address for ` admin ` account |
152157| ` -e SUPERUSER_PASSWORD=<SUPERUSER_PASSWORD> ` | Password for ` admin ` account |
153158| ` -e ALLOWED_HOST=<ALLOWED_HOST> ` | The hostname you will use to access the app (i.e., netbox.example.com) |
154- | ` -e BASE_PATH=<BASE_PATH> ` | The path you will use to access the app (i.e., /netbox, optional, default: none) |
155- | ` -e DB_NAME=<DB_NAME> ` | Database name (optional, default: netbox) |
159+ | ` -e DB_NAME=<DB_NAME> ` | Database name (default: netbox) |
156160| ` -e DB_USER=<DB_USER> ` | Database user |
157161| ` -e DB_PASSWORD=<DB_PASSWORD> ` | Database password |
158- | ` -e DB_HOST=<DB_HOST> ` | Database host (optional, default: postgres) |
159- | ` -e DB_PORT=<DB_PORT> ` | Database port (optional) |
160- | ` -e REDIS_HOST=<REDIS_HOST> ` | Redis host (optional, default: redis) |
161- | ` -e REDIS_PORT=<REDIS_PORT> ` | Redis port number (optional, default: 6379) |
162- | ` -e REDIS_PASSWORD=<REDIS_PASSWORD> ` | Redis password (optional, default: none) |
162+ | ` -e DB_HOST=<DB_HOST> ` | Database host (default: postgres) |
163+ | ` -e DB_PORT=<DB_PORT> ` | Database port (defaul: 5432) |
164+ | ` -e REDIS_HOST=<REDIS_HOST> ` | Redis host (default: redis) |
165+ | ` -e REDIS_PORT=<REDIS_PORT> ` | Redis port number (default: 6379) |
166+ | ` -e REDIS_PASSWORD=<REDIS_PASSWORD> ` | Redis password (default: none) |
167+ | ` -e REDIS_DB_TASK=<REDIS_DB_TASK> ` | Redis database ID for tasks (default: 0) |
168+ | ` -e REDIS_DB_CACHE=<REDIS_DB_CACHE> ` | Redis database ID for caching (default: 1) |
169+ | ` -e BASE_PATH=<BASE_PATH> ` | The path you will use to access the app (i.e., /netbox, optional, default: none) |
163170| ` -e REMOTE_AUTH_ENABLED=<REMOTE_AUTH_ENABLED> ` | Enable remote authentication (optional, default: False) |
164171| ` -e REMOTE_AUTH_BACKEND=<REMOTE_AUTH_BACKEND> ` | Python path to the custom Django authentication backend to use for external user authentication (optional, default: netbox.authentication.RemoteUserBackend) |
165172| ` -e REMOTE_AUTH_HEADER=<REMOTE_AUTH_HEADER> ` | Name of the HTTP header which informs NetBox of the currently authenticated user. (optional, default: HTTP_REMOTE_USER) |
166173| ` -e REMOTE_AUTH_AUTO_CREATE_USER=<REMOTE_AUTH_AUTO_CREATE_USER> ` | If true, NetBox will automatically create local accounts for users authenticated via a remote service (optional, default: False) |
167174| ` -e REMOTE_AUTH_DEFAULT_GROUPS=<REMOTE_AUTH_DEFAULT_GROUPS> ` | The list of groups to assign a new user account when created using remote authentication (optional, default: [ ] ) |
168175| ` -e REMOTE_AUTH_DEFAULT_PERMISSIONS=<REMOTE_AUTH_DEFAULT_PERMISSIONS> ` | A mapping of permissions to assign a new user account when created using remote authentication (optional, default: {}) |
169- | ` -e TZ=<TZ> ` | Timezone (i.e., America/New_York) |
170176| ` -v /config ` | config directory volume mapping |
171177
172178## Environment variables from files (Docker secrets)
@@ -278,6 +284,7 @@ Once registered you can define the dockerfile to use with `-f Dockerfile.aarch64
278284
279285## Versions
280286
287+ * ** 26.04.21:** - Added Redis database environment variables.
281288* ** 03.02.21:** - Added remote authentication environment variables.
282289* ** 02.01.21:** - Added BASE_PATH environment variable.
283290* ** 23.08.20:** - Initial Release.
0 commit comments