Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kyzima-spb/docker-tixati
Tixati torrent client in a docker container
https://github.com/kyzima-spb/docker-tixati
docker docker-image docker-tixati tixati torrent
Last synced: about 3 hours ago
JSON representation
Tixati torrent client in a docker container
- Host: GitHub
- URL: https://github.com/kyzima-spb/docker-tixati
- Owner: kyzima-spb
- Created: 2020-03-04T09:34:57.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-09-15T13:20:07.000Z (about 2 months ago)
- Last Synced: 2024-09-16T02:24:55.632Z (about 2 months ago)
- Topics: docker, docker-image, docker-tixati, tixati, torrent
- Language: Python
- Homepage: https://www.tixati.com
- Size: 469 KB
- Stars: 10
- Watchers: 4
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Tixati torrent client in Docker
[](https://github.com/kyzima-spb/docker-tixati)
[](https://github.com/kyzima-spb/docker-tixati)
[](https://github.com/kyzima-spb/docker-tixati/stargazers)
---
**Attention**
This crazy idea to run GUI applications in the Docker container,
but unfortunately I did not find another way to run Tixati on the server.
Use this image only on servers without a desktop environment.
If your server has a DE, use the installer from the official site.
**Reason for some versions missing:**
* `3.21`, `3.22` - Does not save transfers and settings after closing the program. This behavior is also outside the container.
* `3.24`, `3.25` - Does not save transmissions after program is closed. This behavior is also outside the container.
---
## Run in daemon mode
```bash
$ docker run -d --name tixati_1 --network host kyzimaspb/tixati
```
### Mount points
To store data permanently, two volumes are declared in the image:
* `/tixati/config` - directory with tixati profile
* `/tixati/downloads` - directory with downloaded files
The `/tixati/torrent-files` directory can be used to mount torrent files into a container,
but this directory is not a Docker volume.
### Environment Variables
* `XVFB_RESOLUTION` - screen resolution of the virtual X server, by default `1280x720`
* `VNC_SERVER_PASSWORD` - password for the VNC server, by default not set
* `VNC_SERVER_PASSWORD_FILE` - password for the VNC server, by default not set
* `USER_UID` - user ID, by default is `1000`
* `USER_GID` - user's group ID, by default is `1000`
### Forwarded ports:
* `5900` - TCP port for connecting VNC clients.
Run the container named tixati_1 in daemon mode and mount the specified volumes to the specified directories of the host machine:
```bash
$ docker run -d --name tixati_1 \
--network host \
-v tixati_config:/tixati/config \
-v ./downloads:/tixati/downloads \
-v ./torrent-files:/tixati/torrent-files \
--restart unless-stopped \
kyzimaspb/tixati
```
## Autostart with a password
Automatically start the container at system startup with the password `qwe123` to connect to the VNC server:
```bash
$ docker run -d --name tixati_1 \
--network host \
-e VNC_SERVER_PASSWORD=qwe123 \
-v tixati_config:/tixati/config \
-v ./downloads:/tixati/downloads \
-v ./torrent-files:/tixati/torrent-files \
--restart unless-stopped \
kyzimaspb/tixati
```
## Resource limits
You can use all resource limits available for the `docker run` command. For example, limit the amount of RAM:
```bash
$ docker run -d --name tixati_1 \
--network host \
-m 512M \
-e VNC_SERVER_PASSWORD=qwe123 \
-v tixati_config:/tixati/config \
-v ./downloads:/tixati/downloads \
-v ./torrent-files:/tixati/torrent-files \
--restart unless-stopped \
kyzimaspb/tixati
```
## How to run a container as a specified user?
You can use any user or group ID - existing or not:
```bash
$ docker run -d --name tixati_1 \
--network host \
-e USER_UID=1001 \
-e USER_GID=1001 \
-e VNC_SERVER_PASSWORD=qwe123 \
-v tixati_config:/tixati/config \
-v ./downloads:/tixati/downloads \
-v ./torrent-files:/tixati/torrent-files \
--restart unless-stopped \
kyzimaspb/tixati
```
## How to change Tixati version?
The `TIXATI_VERSION` build argument allows you to specify the version of Tixati:
```bash
$ git clone https://github.com/kyzima-spb/docker-tixati.git
$ cd docker-tixati
$ docker build -t tixati --build-arg TIXATI_VERSION=2.67 .
```
## How to change distribution release?
The `RELEASE` build argument allows you to specify the release of the Debian distribution.
Available values: `bookworm-slim`, `bookworm`, `bullseye-slim`, `bullseye`,
`buster-slim`, `buster`:
```bash
$ git clone https://github.com/kyzima-spb/docker-tixati.git
$ cd docker-tixati
$ docker build -t tixati --build-arg RELEASE=buster-slim .
```