### Run qBittorrent-nox Container with Docker Compose

Source: https://github.com/qbittorrent/docker-qbittorrent-nox/blob/main/manual_build/Readme.md

This command starts the qBittorrent-nox container using Docker Compose. It assumes you have a `docker-compose.yml` file configured for the service.

```shell
docker compose up
```

--------------------------------

### Installing Debugging Packages

Source: https://github.com/qbittorrent/docker-qbittorrent-nox/blob/main/Readme.md

Install gdb and musl-dbg within the container using the apk package manager.

```shell
apk add \
  gdb \
  musl-dbg
```

--------------------------------

### Build Docker Image with Docker

Source: https://github.com/qbittorrent/docker-qbittorrent-nox/blob/main/manual_build/Readme.md

Use this command to build the Docker image if you are not using Docker Compose. Ensure you have Docker installed.

```shell
export \
  QBT_VERSION=devel
docker build \
  --build-arg QBT_VERSION \
  -t qbittorrent-nox:"$QBT_VERSION" \
  .
```

--------------------------------

### Run qBittorrent-nox Container with Docker

Source: https://github.com/qbittorrent/docker-qbittorrent-nox/blob/main/manual_build/Readme.md

This command launches the qBittorrent-nox container using Docker. It sets up necessary environment variables for configuration, maps ports for torrenting and web UI access, and mounts volumes for persistent storage. Ensure you set the QBT_CONFIG_PATH and QBT_DOWNLOADS_PATH variables to your desired host paths.

```shell
export \
    QBT_LEGAL_NOTICE=<put_confirm_here> \
    QBT_VERSION=devel \
    QBT_TORRENTING_PORT=6881 \
    QBT_WEBUI_PORT=8080 \
    QBT_CONFIG_PATH="<your_path>/config" \
    QBT_DOWNLOADS_PATH="<your_path>/downloads"
docker run \
    -t \
    --name qbittorrent-nox \
    --read-only \
    --rm \
    --stop-timeout 1800 \
    --tmpfs /tmp \
    -e QBT_LEGAL_NOTICE \
    -e QBT_TORRENTING_PORT \
    -e QBT_WEBUI_PORT \
    -e TZ=UTC \
    -p "$QBT_TORRENTING_PORT":"$QBT_TORRENTING_PORT"/tcp \
    -p "$QBT_TORRENTING_PORT":"$QBT_TORRENTING_PORT"/udp \
    -p "$QBT_WEBUI_PORT":"$QBT_WEBUI_PORT"/tcp \
    -v "$QBT_CONFIG_PATH":/config \
    -v "$QBT_DOWNLOADS_PATH":/downloads \
    qbittorrent-nox:"$QBT_VERSION"
```

--------------------------------

### Attaching gdb to qbittorrent-nox Process

Source: https://github.com/qbittorrent/docker-qbittorrent-nox/blob/main/Readme.md

Find the process ID (PID) of qbittorrent-nox using 'ps -a' and then attach gdb using 'gdb -p <PID>'.

```shell
# to find PID of qbittorrent-nox
ps -a
# attach debugger
gdb -p <PID>
```

--------------------------------

### Run qbittorrent-nox with Docker

Source: https://github.com/qbittorrent/docker-qbittorrent-nox/blob/main/Readme.md

This command runs the qbittorrent-nox container using direct Docker commands. Ensure environment variables are exported before execution. It maps ports, mounts volumes for configuration and downloads, and sets a stop timeout for graceful shutdown.

```shell
export \
  QBT_LEGAL_NOTICE=<put_confirm_here> \
  QBT_VERSION=latest \
  QBT_TORRENTING_PORT=6881 \
  QBT_WEBUI_PORT=8080 \
  QBT_CONFIG_PATH="<your_path>/config" \
  QBT_DOWNLOADS_PATH="<your_path>/downloads"
docker run \
  -t \
  --name qbittorrent-nox \
  --read-only \
  --rm \
  --stop-timeout 1800 \
  --tmpfs /tmp \
  -e QBT_LEGAL_NOTICE \
  -e QBT_TORRENTING_PORT \
  -e QBT_WEBUI_PORT \
  -p "$QBT_TORRENTING_PORT":"$QBT_TORRENTING_PORT"/tcp \
  -p "$QBT_TORRENTING_PORT":"$QBT_TORRENTING_PORT"/udp \
  -p "$QBT_WEBUI_PORT":"$QBT_WEBUI_PORT"/tcp \
  -v "$QBT_CONFIG_PATH":/config \
  -v "$QBT_DOWNLOADS_PATH":/downloads \
  qbittorrentofficial/qbittorrent-nox:${QBT_VERSION}
```

--------------------------------

### Retrieve Software Bill of Materials (SBOM)

Source: https://github.com/qbittorrent/docker-qbittorrent-nox/blob/main/manual_build/Readme.md

This command retrieves the Software Bill of Materials (SBOM) for the qBittorrent-nox image. It temporarily overrides the entrypoint to display the content of the SBOM file.

```shell
docker run --entrypoint /bin/cat --rm qbittorrentofficial/qbittorrent-nox:latest /sbom.txt
```

--------------------------------

### Build Docker Image with Docker Compose

Source: https://github.com/qbittorrent/docker-qbittorrent-nox/blob/main/manual_build/Readme.md

Use this command to build the Docker image when using Docker Compose. Remember to configure the .env file first.

```shell
docker compose build \
  --build-arg QBT_VERSION
```

--------------------------------

### Dropping into a Docker Container

Source: https://github.com/qbittorrent/docker-qbittorrent-nox/blob/main/Readme.md

Use 'docker ps' to find the container ID and then 'docker exec -it <container_id> /bin/sh' to access the container's shell.

```shell
# to find container id
docker ps
# drop into container
docker exec -it <container_id> /bin/sh
```

--------------------------------

### Stop qBittorrent-nox Container with Docker

Source: https://github.com/qbittorrent/docker-qbittorrent-nox/blob/main/manual_build/Readme.md

This command gracefully stops the running qBittorrent-nox container managed by Docker. It utilizes the `--stop-timeout` value set during the `docker run` command.

```shell
docker stop qbittorrent-nox
```

--------------------------------

### Stop qBittorrent-nox Container with Docker Compose

Source: https://github.com/qbittorrent/docker-qbittorrent-nox/blob/main/manual_build/Readme.md

This command stops and removes the qBittorrent-nox container and associated resources defined in your Docker Compose configuration.

```shell
docker compose down
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.