Skip to content

Commit 3b211d5

Browse files
Bot Updating Templated Files
1 parent 78e4255 commit 3b211d5

File tree

1 file changed

+32
-25
lines changed

1 file changed

+32
-25
lines changed

README.md

+32-25
Original file line numberDiff line numberDiff line change
@@ -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

6464
Access 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

Comments
 (0)