From 7cae91e685412c6207e9f1d275bf1ab355eba830 Mon Sep 17 00:00:00 2001 From: Mogeko Date: Tue, 16 Nov 2021 18:54:54 +0000 Subject: [PATCH] docs(readme): add rootless related guidelines --- README.md | 17 +++++++++++++---- 1 file changed, 13 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index dff2549..289e5c5 100644 --- a/README.md +++ b/README.md @@ -4,12 +4,17 @@ Docker image for qBittorrent. +- Tiny size +- Enable rootless[^1] +- Enable `QBT_*` options[^2] +- Keep updating + ## Usage Pull this image: ```shell -docker pull ghcr.io/mogeko/qbittorrent:edge +docker pull ghcr.io/mogeko/qbittorrent ``` Run with docker cli: @@ -17,6 +22,7 @@ Run with docker cli: ```shell docker run -d \ --name qbittorrent \ + --user 1000:100 `#optional` \ -e QBT_WEBUI_PORT=8080 \ -p 6881:6881 \ -p 6881:6881/udp \ @@ -35,6 +41,7 @@ services: qbittorrent: image: ghcr.io/mogeko/qbittorrent container_name: qbittorrent + user: 1000:100 #optional environment: - QBT_WEBUI_PORT=8080 volumes: @@ -58,12 +65,12 @@ Container images are configured using parameters passed at runtime (such as thos | `-e QBT_WEBUI_PORT=8080` | Change the Web UI port | | `-v /downloads` | Location of downloads on disk | -The `qbittorrent-nox`'s options may be supplied via environment variables[^1]. For option named 'parameter-name', environment variable name is `QBT_PARAMETER_NAME` (in uppercase, `-` replaced with `_`). To pass flag values, set the variable to `1` or `TRUE`. Here is an example we already in used: `-e QBT_WEBUI_PORT=8080`. +The `qbittorrent-nox`'s options may be supplied via environment variables[^2]. For option named 'parameter-name', environment variable name is `QBT_PARAMETER_NAME` (in uppercase, `-` replaced with `_`). To pass flag values, set the variable to `1` or `TRUE`. Here is an example we already in used: `-e QBT_WEBUI_PORT=8080`. More help message about `qbittorrent-nox`, you can get via: ```shell -docker run -it ghcr.io/mogeko/qbittorrent:edge --help +docker run -it ghcr.io/mogeko/qbittorrent --help ``` ## License @@ -73,7 +80,8 @@ The code in this project is released under the [GPL-3.0 License][license]. -[^1]: The option `QBT_PROFILE` does not support. +[^1]: This image should be able to work with [podman], but it has not been tested. +[^2]: The option `QBT_PROFILE` does not support. @@ -84,3 +92,4 @@ The code in this project is released under the [GPL-3.0 License][license]. [docker-compose]: https://docs.docker.com/compose [license]: https://github.com/mogeko/docker-qbittorrent/blob/master/LICENSE +[podman]: https://podman.io