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
[](https://blog.linuxserver.io"all the things you can do with our containers including How-To guides, opinions and much more!")
@@ -97,7 +96,7 @@ We automatically add the necessary environment variable that will utilise all th
97
96
98
97
## Usage
99
98
100
-
Here are some example snippets to help you get started creating a container.
99
+
To help you get started creating a container from this image you can either use docker-compose or the docker cli.
101
100
102
101
### docker-compose (recommended, [click here for more info](https://docs.linuxserver.io/general/docker-compose))
103
102
@@ -138,12 +137,11 @@ docker run -d \
138
137
-v /path/to/movies:/movies \
139
138
--restart unless-stopped \
140
139
lscr.io/linuxserver/plex:latest
141
-
142
140
```
143
141
144
142
## Parameters
145
143
146
-
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.
144
+
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.
147
145
148
146
| Parameter | Function |
149
147
| :----: | --- |
@@ -164,10 +162,10 @@ You can set any environment variable from a file by using a special prepend `FIL
164
162
As an example:
165
163
166
164
```bash
167
-
-e FILE__PASSWORD=/run/secrets/mysecretpassword
165
+
-e FILE__MYVAR=/run/secrets/mysecretvariable
168
166
```
169
167
170
-
Will set the environment variable `PASSWORD` based on the contents of the `/run/secrets/mysecretpassword` file.
168
+
Will set the environment variable `MYVAR` based on the contents of the `/run/secrets/mysecretvariable` file.
171
169
172
170
## Umask for running applications
173
171
@@ -203,15 +201,20 @@ The application accepts a series of environment variables to further customize i
203
201
204
202
## User / Group Identifiers
205
203
206
-
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`.
204
+
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`.
207
205
208
206
Ensure any volume directories on the host are owned by the same user you specify and any permissions issues will vanish like magic.
209
207
210
-
In this instance `PUID=1000` and `PGID=1000`, to find yours use `id user` as below:
208
+
In this instance `PUID=1000` and `PGID=1000`, to find yours use `id your_user` as below:
@@ -222,12 +225,29 @@ We publish various [Docker Mods](https://github.com/linuxserver/docker-mods) to
222
225
223
226
## Support Info
224
227
225
-
* Shell access whilst the container is running: `docker exec -it plex /bin/bash`
226
-
* To monitor the logs of the container in realtime: `docker logs -f plex`
227
-
* container version number
228
-
*`docker inspect -f '{{ index .Config.Labels "build_version" }}' plex`
229
-
* image version number
230
-
*`docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/plex:latest`
228
+
* Shell access whilst the container is running:
229
+
230
+
```bash
231
+
docker exec -it plex /bin/bash
232
+
```
233
+
234
+
* To monitor the logs of the container in realtime:
235
+
236
+
```bash
237
+
docker logs -f plex
238
+
```
239
+
240
+
* Container version number:
241
+
242
+
```bash
243
+
docker inspect -f '{{ index .Config.Labels "build_version" }}' plex
244
+
```
245
+
246
+
* Image version number:
247
+
248
+
```bash
249
+
docker inspect -f '{{ index .Config.Labels "build_version" }}' lscr.io/linuxserver/plex:latest
250
+
```
231
251
232
252
## Updating Info
233
253
@@ -237,38 +257,83 @@ Below are the instructions for updating containers:
237
257
238
258
### Via Docker Compose
239
259
240
-
* Update all images: `docker-compose pull`
241
-
* or update a single image: `docker-compose pull plex`
242
-
* Let compose update all containers as necessary: `docker-compose up -d`
243
-
* or update a single container: `docker-compose up -d plex`
244
-
* You can also remove the old dangling images: `docker image prune`
260
+
* Update images:
261
+
* All images:
262
+
263
+
```bash
264
+
docker-compose pull
265
+
```
266
+
267
+
* Single image:
268
+
269
+
```bash
270
+
docker-compose pull plex
271
+
```
272
+
273
+
* Update containers:
274
+
* All containers:
275
+
276
+
```bash
277
+
docker-compose up -d
278
+
```
279
+
280
+
* Single container:
281
+
282
+
```bash
283
+
docker-compose up -d plex
284
+
```
285
+
286
+
* You can also remove the old dangling images:
287
+
288
+
```bash
289
+
docker image prune
290
+
```
245
291
246
292
### Via Docker Run
247
293
248
-
* Update the image: `docker pull lscr.io/linuxserver/plex:latest`
249
-
* Stop the running container: `docker stop plex`
250
-
* Delete the container: `docker rm plex`
294
+
* Update the image:
295
+
296
+
```bash
297
+
docker pull lscr.io/linuxserver/plex:latest
298
+
```
299
+
300
+
* Stop the running container:
301
+
302
+
```bash
303
+
docker stop plex
304
+
```
305
+
306
+
* Delete the container:
307
+
308
+
```bash
309
+
docker rm plex
310
+
```
311
+
251
312
* 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)
252
-
* You can also remove the old dangling images: `docker image prune`
313
+
* You can also remove the old dangling images:
314
+
315
+
```bash
316
+
docker image prune
317
+
```
253
318
254
319
### Via Watchtower auto-updater (only use if you don't remember the original parameters)
255
320
256
321
* Pull the latest image at its tag and replace it with the same env variables in one run:
257
322
258
-
```bash
259
-
docker run --rm \
260
-
-v /var/run/docker.sock:/var/run/docker.sock \
261
-
containrrr/watchtower \
262
-
--run-once plex
263
-
```
323
+
```bash
324
+
docker run --rm \
325
+
-v /var/run/docker.sock:/var/run/docker.sock \
326
+
containrrr/watchtower \
327
+
--run-once plex
328
+
```
264
329
265
330
* You can also remove the old dangling images: `docker image prune`
266
331
267
-
**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).
332
+
**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.
336
+
**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