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 3, 2025. 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!")
@@ -73,7 +72,7 @@ If you are using a reverse proxy which validates certificates, you need to [disa
73
72
74
73
## Usage
75
74
76
-
Here are some example snippets to help you get started creating a container.
75
+
To help you get started creating a container from this image you can either use docker-compose or the docker cli.
77
76
78
77
### docker-compose (recommended, [click here for more info](https://docs.linuxserver.io/general/docker-compose))
79
78
@@ -113,12 +112,11 @@ docker run -d \
113
112
-v /path/to/data:/config \
114
113
--restart unless-stopped \
115
114
lscr.io/linuxserver/quassel-web:latest
116
-
117
115
```
118
116
119
117
## Parameters
120
118
121
-
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.
119
+
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.
122
120
123
121
| Parameter | Function |
124
122
| :----: | --- |
@@ -138,10 +136,10 @@ You can set any environment variable from a file by using a special prepend `FIL
138
136
As an example:
139
137
140
138
```bash
141
-
-e FILE__PASSWORD=/run/secrets/mysecretpassword
139
+
-e FILE__MYVAR=/run/secrets/mysecretvariable
142
140
```
143
141
144
-
Will set the environment variable `PASSWORD` based on the contents of the `/run/secrets/mysecretpassword` file.
142
+
Will set the environment variable `MYVAR` based on the contents of the `/run/secrets/mysecretvariable` file.
145
143
146
144
## Umask for running applications
147
145
@@ -150,15 +148,20 @@ Keep in mind umask is not chmod it subtracts from permissions based on it's valu
150
148
151
149
## User / Group Identifiers
152
150
153
-
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`.
151
+
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`.
154
152
155
153
Ensure any volume directories on the host are owned by the same user you specify and any permissions issues will vanish like magic.
156
154
157
-
In this instance `PUID=1000` and `PGID=1000`, to find yours use `id user` as below:
155
+
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)
199
-
* You can also remove the old dangling images: `docker image prune`
260
+
* You can also remove the old dangling images:
261
+
262
+
```bash
263
+
docker image prune
264
+
```
200
265
201
266
### Via Watchtower auto-updater (only use if you don't remember the original parameters)
202
267
203
268
* Pull the latest image at its tag and replace it with the same env variables in one run:
204
269
205
-
```bash
206
-
docker run --rm \
207
-
-v /var/run/docker.sock:/var/run/docker.sock \
208
-
containrrr/watchtower \
209
-
--run-once quassel-web
210
-
```
270
+
```bash
271
+
docker run --rm \
272
+
-v /var/run/docker.sock:/var/run/docker.sock \
273
+
containrrr/watchtower \
274
+
--run-once quassel-web
275
+
```
211
276
212
277
* You can also remove the old dangling images: `docker image prune`
213
278
214
-
**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).
279
+
**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.
283
+
**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