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!")
@@ -66,7 +65,7 @@ Whilst this is a more up to date rebase of the original Booksonic server, upgrad
66
65
67
66
## Usage
68
67
69
-
Here are some example snippets to help you get started creating a container.
68
+
To help you get started creating a container from this image you can either use docker-compose or the docker cli.
70
69
71
70
### docker-compose (recommended, [click here for more info](https://docs.linuxserver.io/general/docker-compose))
72
71
@@ -108,12 +107,11 @@ docker run -d \
108
107
-v /path/to/othermedia:/othermedia \
109
108
--restart unless-stopped \
110
109
lscr.io/linuxserver/booksonic-air:latest
111
-
112
110
```
113
111
114
112
## Parameters
115
113
116
-
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.
114
+
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.
117
115
118
116
| Parameter | Function |
119
117
| :----: | --- |
@@ -134,10 +132,10 @@ You can set any environment variable from a file by using a special prepend `FIL
134
132
As an example:
135
133
136
134
```bash
137
-
-e FILE__PASSWORD=/run/secrets/mysecretpassword
135
+
-e FILE__MYVAR=/run/secrets/mysecretvariable
138
136
```
139
137
140
-
Will set the environment variable `PASSWORD` based on the contents of the `/run/secrets/mysecretpassword` file.
138
+
Will set the environment variable `MYVAR` based on the contents of the `/run/secrets/mysecretvariable` file.
141
139
142
140
## Umask for running applications
143
141
@@ -146,15 +144,20 @@ Keep in mind umask is not chmod it subtracts from permissions based on it's valu
146
144
147
145
## User / Group Identifiers
148
146
149
-
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`.
147
+
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`.
150
148
151
149
Ensure any volume directories on the host are owned by the same user you specify and any permissions issues will vanish like magic.
152
150
153
-
In this instance `PUID=1000` and `PGID=1000`, to find yours use `id user` as below:
151
+
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)
195
-
* You can also remove the old dangling images: `docker image prune`
256
+
* You can also remove the old dangling images:
257
+
258
+
```bash
259
+
docker image prune
260
+
```
196
261
197
262
### Via Watchtower auto-updater (only use if you don't remember the original parameters)
198
263
199
264
* Pull the latest image at its tag and replace it with the same env variables in one run:
200
265
201
-
```bash
202
-
docker run --rm \
203
-
-v /var/run/docker.sock:/var/run/docker.sock \
204
-
containrrr/watchtower \
205
-
--run-once booksonic-air
206
-
```
266
+
```bash
267
+
docker run --rm \
268
+
-v /var/run/docker.sock:/var/run/docker.sock \
269
+
containrrr/watchtower \
270
+
--run-once booksonic-air
271
+
```
207
272
208
273
* You can also remove the old dangling images: `docker image prune`
209
274
210
-
**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).
275
+
**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.
279
+
**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