Skip to content
This repository was archived by the owner on Jan 7, 2024. It is now read-only.

Commit 26bef0a

Browse files
Bot Updating Templated Files
1 parent ce02a55 commit 26bef0a

File tree

1 file changed

+101
-35
lines changed

1 file changed

+101
-35
lines changed

README.md

+101-35
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
1-
<!-- DO NOT EDIT THIS FILE MANUALLY -->
2-
<!-- Please read the https://github.com/linuxserver/docker-unifi-controller/blob/mongoless/.github/CONTRIBUTING.md -->
3-
1+
<!-- DO NOT EDIT THIS FILE MANUALLY -->
2+
<!-- Please read https://github.com/linuxserver/docker-unifi-controller/blob/mongoless/.github/CONTRIBUTING.md -->
43
[![linuxserver.io](https://raw.githubusercontent.com/linuxserver/docker-templates/master/linuxserver.io/img/linuxserver_medium.png)](https://linuxserver.io)
54

65
[![Blog](https://img.shields.io/static/v1.svg?color=94398d&labelColor=555555&logoColor=ffffff&style=for-the-badge&label=linuxserver.io&message=Blog)](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
6564
| :----: | :----: |--- |
6665
| latest || Stable Unifi Controller releases. |
6766
| mongoless || Stable Unifi Controller releases without mongodb included. |
67+
6868
## Application Setup
6969

7070
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
105105

106106
## Usage
107107

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.
109109

110110
### docker-compose (recommended, [click here for more info](https://docs.linuxserver.io/general/docker-compose))
111111

@@ -169,12 +169,11 @@ docker run -d \
169169
-v /path/to/data:/config \
170170
--restart unless-stopped \
171171
lscr.io/linuxserver/unifi-controller:mongoless
172-
173172
```
174173

175174
## Parameters
176175

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.
178177

179178
| Parameter | Function |
180179
| :----: | --- |
@@ -206,10 +205,10 @@ You can set any environment variable from a file by using a special prepend `FIL
206205
As an example:
207206

208207
```bash
209-
-e FILE__PASSWORD=/run/secrets/mysecretpassword
208+
-e FILE__MYVAR=/run/secrets/mysecretvariable
210209
```
211210

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.
213212

214213
## Umask for running applications
215214

@@ -218,15 +217,20 @@ Keep in mind umask is not chmod it subtracts from permissions based on it's valu
218217

219218
## User / Group Identifiers
220219

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`.
222221

223222
Ensure any volume directories on the host are owned by the same user you specify and any permissions issues will vanish like magic.
224223

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:
226225

227226
```bash
228-
$ id username
229-
uid=1000(dockeruser) gid=1000(dockergroup) groups=1000(dockergroup)
227+
id your_user
228+
```
229+
230+
Example output:
231+
232+
```text
233+
uid=1000(your_user) gid=1000(your_user) groups=1000(your_user)
230234
```
231235

232236
## Docker Mods
@@ -237,12 +241,29 @@ We publish various [Docker Mods](https://github.com/linuxserver/docker-mods) to
237241

238242
## Support Info
239243

240-
* Shell access whilst the container is running: `docker exec -it unifi-controller /bin/bash`
241-
* To monitor the logs of the container in realtime: `docker logs -f unifi-controller`
242-
* container version number
243-
* `docker inspect -f '{{ index .Config.Labels "build_version" }}' unifi-controller`
244-
* image version number
245-
* `docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/unifi-controller:mongoless`
244+
* Shell access whilst the container is running:
245+
246+
```bash
247+
docker exec -it unifi-controller /bin/bash
248+
```
249+
250+
* To monitor the logs of the container in realtime:
251+
252+
```bash
253+
docker logs -f unifi-controller
254+
```
255+
256+
* Container version number:
257+
258+
```bash
259+
docker inspect -f '{{ index .Config.Labels "build_version" }}' unifi-controller
260+
```
261+
262+
* Image version number:
263+
264+
```bash
265+
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/unifi-controller:mongoless
266+
```
246267

247268
## Updating Info
248269

@@ -252,38 +273,83 @@ Below are the instructions for updating containers:
252273

253274
### Via Docker Compose
254275

255-
* Update all images: `docker-compose pull`
256-
* or update a single image: `docker-compose pull unifi-controller`
257-
* Let compose update all containers as necessary: `docker-compose up -d`
258-
* or update a single container: `docker-compose up -d unifi-controller`
259-
* You can also remove the old dangling images: `docker image prune`
276+
* Update images:
277+
* All images:
278+
279+
```bash
280+
docker-compose pull
281+
```
282+
283+
* Single image:
284+
285+
```bash
286+
docker-compose pull unifi-controller
287+
```
288+
289+
* Update containers:
290+
* All containers:
291+
292+
```bash
293+
docker-compose up -d
294+
```
295+
296+
* Single container:
297+
298+
```bash
299+
docker-compose up -d unifi-controller
300+
```
301+
302+
* You can also remove the old dangling images:
303+
304+
```bash
305+
docker image prune
306+
```
260307

261308
### Via Docker Run
262309

263-
* Update the image: `docker pull lscr.io/linuxserver/unifi-controller:mongoless`
264-
* Stop the running container: `docker stop unifi-controller`
265-
* Delete the container: `docker rm unifi-controller`
310+
* Update the image:
311+
312+
```bash
313+
docker pull lscr.io/linuxserver/unifi-controller:mongoless
314+
```
315+
316+
* Stop the running container:
317+
318+
```bash
319+
docker stop unifi-controller
320+
```
321+
322+
* Delete the container:
323+
324+
```bash
325+
docker rm unifi-controller
326+
```
327+
266328
* 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+
```
268334

269335
### Via Watchtower auto-updater (only use if you don't remember the original parameters)
270336

271337
* Pull the latest image at its tag and replace it with the same env variables in one run:
272338

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+
```
279345

280346
* You can also remove the old dangling images: `docker image prune`
281347

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).
283349

284350
### Image Update Notifications - Diun (Docker Image Update Notifier)
285351

286-
* 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.
287353

288354
## Building locally
289355

0 commit comments

Comments
 (0)