@@ -59,7 +59,7 @@ The architectures supported by this image are:
59
59
60
60
## Application Setup
61
61
62
- Netbox requires a postgres database.
62
+ Netbox requires a postgres database and a redis instance .
63
63
64
64
Access the WebUI at <your-ip >:8000. For more information, check out [ NetBox] ( https://github.com/netbox-community/netbox ) .
65
65
@@ -81,10 +81,10 @@ services:
81
81
environment :
82
82
- PUID=1000
83
83
- PGID=1000
84
+ - TZ=<TZ>
84
85
- SUPERUSER_EMAIL=<SUPERUSER_EMAIL>
85
86
- SUPERUSER_PASSWORD=<SUPERUSER_PASSWORD>
86
87
- ALLOWED_HOST=<ALLOWED_HOST>
87
- - BASE_PATH=<BASE_PATH>
88
88
- DB_NAME=<DB_NAME>
89
89
- DB_USER=<DB_USER>
90
90
- DB_PASSWORD=<DB_PASSWORD>
@@ -93,13 +93,15 @@ services:
93
93
- REDIS_HOST=<REDIS_HOST>
94
94
- REDIS_PORT=<REDIS_PORT>
95
95
- 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
103
105
volumes :
104
106
- <path to data on host>:/config
105
107
ports :
@@ -114,10 +116,10 @@ docker run -d \
114
116
--name=netbox \
115
117
-e PUID=1000 \
116
118
-e PGID=1000 \
119
+ -e TZ=<TZ> \
117
120
-e SUPERUSER_EMAIL=<SUPERUSER_EMAIL> \
118
121
-e SUPERUSER_PASSWORD=<SUPERUSER_PASSWORD> \
119
122
-e ALLOWED_HOST=<ALLOWED_HOST> \
120
- -e BASE_PATH=<BASE_PATH> \
121
123
-e DB_NAME=<DB_NAME> \
122
124
-e DB_USER=<DB_USER> \
123
125
-e DB_PASSWORD=<DB_PASSWORD> \
@@ -126,13 +128,15 @@ docker run -d \
126
128
-e REDIS_HOST=<REDIS_HOST> \
127
129
-e REDIS_PORT=<REDIS_PORT> \
128
130
-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` \
136
140
-p 8000:8000 \
137
141
-v <path to data on host>:/config \
138
142
--restart unless-stopped \
@@ -148,25 +152,27 @@ Container images are configured using parameters passed at runtime (such as thos
148
152
| ` -p 8000 ` | will map the container's port 8000 to port 8000 on the host |
149
153
| ` -e PUID=1000 ` | for UserID - see below for explanation |
150
154
| ` -e PGID=1000 ` | for GroupID - see below for explanation |
155
+ | ` -e TZ=<TZ> ` | Timezone (i.e., America/New_York) |
151
156
| ` -e SUPERUSER_EMAIL=<SUPERUSER_EMAIL> ` | Email address for ` admin ` account |
152
157
| ` -e SUPERUSER_PASSWORD=<SUPERUSER_PASSWORD> ` | Password for ` admin ` account |
153
158
| ` -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) |
156
160
| ` -e DB_USER=<DB_USER> ` | Database user |
157
161
| ` -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) |
163
170
| ` -e REMOTE_AUTH_ENABLED=<REMOTE_AUTH_ENABLED> ` | Enable remote authentication (optional, default: False) |
164
171
| ` -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) |
165
172
| ` -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) |
166
173
| ` -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) |
167
174
| ` -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: [ ] ) |
168
175
| ` -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) |
170
176
| ` -v /config ` | config directory volume mapping |
171
177
172
178
## Environment variables from files (Docker secrets)
@@ -278,6 +284,7 @@ Once registered you can define the dockerfile to use with `-f Dockerfile.aarch64
278
284
279
285
## Versions
280
286
287
+ * ** 26.04.21:** - Added Redis database environment variables.
281
288
* ** 03.02.21:** - Added remote authentication environment variables.
282
289
* ** 02.01.21:** - Added BASE_PATH environment variable.
283
290
* ** 23.08.20:** - Initial Release.
0 commit comments