# qbit

> A qbittorrent client, main usage is for *rr services (exist in other recipes).

<!-- metadata -->

* **Category**: Apps
* **Status**: 0
* **Image**: [`qbit`](https://hub.docker.com/r/qbit), 4, upstream
* **Healthcheck**: Partial (only vpn connectivity)
* **Backups**: No
* **Email**: No
* **Tests**: No
* **SSO**: No
* **Maintainers**: RTM - POC: `@ammaratef45:matrix.org`

<!-- endmetadata -->

## Quick start

* `abra app new qbit --secrets`
* `abra app config <app-name>`
* `abra app deploy <app-name>`

For more, see [`docs.coopcloud.tech`](https://docs.coopcloud.tech).

## VPN

* Save wireguard config file in a file named vpn.conf
* `abra app cp <app-name> vpn.conf app:/etc/wireguard/vpn.conf`
* `abra app cmd qbit.ammaratef45.ddns.net app setup_vpn` (this will also start the vpn)
* `start_vpn`, `stop_vpn`, `vpn_status`, and `container_ip` functions commands can be used to manage the vpn connection.
* `kill_siwtch_on` and `kill_switch_off` will cause health-check to fail or not fail respectively when the vpn is not connected.

## Build

```
version=<specify-version>
docker build --platform linux/amd64 -t git.coopcloud.tech/rtm/qbit-vpn:$version .
docker push git.coopcloud.tech/rtm/qbit-vpn:$version
```