You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
This repository was archived by the owner on Jan 7, 2024. It is now read-only.
[](https://blog.linuxserver.io"all the things you can do with our containers including How-To guides, opinions and much more!")
@@ -65,6 +64,7 @@ This image provides various versions that are available via tags. Please read th
The webui is at https://ip:8443, setup with the first run wizard.
@@ -105,7 +105,7 @@ If you are using a reverse proxy which validates certificates, you need to [disa
105
105
106
106
## Usage
107
107
108
-
Here are some example snippets to help you get started creating a container.
108
+
To help you get started creating a container from this image you can either use docker-compose or the docker cli.
109
109
110
110
### docker-compose (recommended, [click here for more info](https://docs.linuxserver.io/general/docker-compose))
111
111
@@ -169,12 +169,11 @@ docker run -d \
169
169
-v /path/to/data:/config \
170
170
--restart unless-stopped \
171
171
lscr.io/linuxserver/unifi-controller:mongoless
172
-
173
172
```
174
173
175
174
## Parameters
176
175
177
-
Container images are configured using parameters passed at runtime (such as those above). These parameters are separated by a colon and indicate `<external>:<internal>` respectively. For example, `-p 8080:80` would expose port `80` from inside the container to be accessible from the host's IP on port `8080` outside the container.
176
+
Containers are configured using parameters passed at runtime (such as those above). These parameters are separated by a colon and indicate `<external>:<internal>` respectively. For example, `-p 8080:80` would expose port `80` from inside the container to be accessible from the host's IP on port `8080` outside the container.
178
177
179
178
| Parameter | Function |
180
179
| :----: | --- |
@@ -206,10 +205,10 @@ You can set any environment variable from a file by using a special prepend `FIL
206
205
As an example:
207
206
208
207
```bash
209
-
-e FILE__PASSWORD=/run/secrets/mysecretpassword
208
+
-e FILE__MYVAR=/run/secrets/mysecretvariable
210
209
```
211
210
212
-
Will set the environment variable `PASSWORD` based on the contents of the `/run/secrets/mysecretpassword` file.
211
+
Will set the environment variable `MYVAR` based on the contents of the `/run/secrets/mysecretvariable` file.
213
212
214
213
## Umask for running applications
215
214
@@ -218,15 +217,20 @@ Keep in mind umask is not chmod it subtracts from permissions based on it's valu
218
217
219
218
## User / Group Identifiers
220
219
221
-
When using volumes (`-v` flags) permissions issues can arise between the host OS and the container, we avoid this issue by allowing you to specify the user `PUID` and group `PGID`.
220
+
When using volumes (`-v` flags), permissions issues can arise between the host OS and the container, we avoid this issue by allowing you to specify the user `PUID` and group `PGID`.
222
221
223
222
Ensure any volume directories on the host are owned by the same user you specify and any permissions issues will vanish like magic.
224
223
225
-
In this instance `PUID=1000` and `PGID=1000`, to find yours use `id user` as below:
224
+
In this instance `PUID=1000` and `PGID=1000`, to find yours use `id your_user` as below:
* Recreate a new container with the same docker run parameters as instructed above (if mapped correctly to a host folder, your `/config` folder and settings will be preserved)
267
-
* You can also remove the old dangling images: `docker image prune`
329
+
* You can also remove the old dangling images:
330
+
331
+
```bash
332
+
docker image prune
333
+
```
268
334
269
335
### Via Watchtower auto-updater (only use if you don't remember the original parameters)
270
336
271
337
* Pull the latest image at its tag and replace it with the same env variables in one run:
272
338
273
-
```bash
274
-
docker run --rm \
275
-
-v /var/run/docker.sock:/var/run/docker.sock \
276
-
containrrr/watchtower \
277
-
--run-once unifi-controller
278
-
```
339
+
```bash
340
+
docker run --rm \
341
+
-v /var/run/docker.sock:/var/run/docker.sock \
342
+
containrrr/watchtower \
343
+
--run-once unifi-controller
344
+
```
279
345
280
346
* You can also remove the old dangling images: `docker image prune`
281
347
282
-
**Note:** We do not endorse the use of Watchtower as a solution to automated updates of existing Docker containers. In fact we generally discourage automated updates. However, this is a useful tool for one-time manual updates of containers where you have forgotten the original parameters. In the long term, we highly recommend using [Docker Compose](https://docs.linuxserver.io/general/docker-compose).
348
+
**warning**: We do not endorse the use of Watchtower as a solution to automated updates of existing Docker containers. In fact we generally discourage automated updates. However, this is a useful tool for one-time manual updates of containers where you have forgotten the original parameters. In the long term, we highly recommend using [Docker Compose](https://docs.linuxserver.io/general/docker-compose).
* We recommend [Diun](https://crazymax.dev/diun/) for update notifications. Other tools that automatically update containers unattended are not recommended or supported.
352
+
**tip**: We recommend [Diun](https://crazymax.dev/diun/) for update notifications. Other tools that automatically update containers unattended are not recommended or supported.
0 commit comments