Skip to content

Latest commit

 

History

History
130 lines (98 loc) · 4.23 KB

README.md

File metadata and controls

130 lines (98 loc) · 4.23 KB
Raw

Tixati torrent client in Docker

Github Repo GitHub last commit GitHub Repo stars

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.

Tixati Screenshot

Run in daemon mode

$ 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:

$ 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:

$ 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:

$ 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:

$ 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:

$ 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:

$ git clone https://github.com/kyzima-spb/docker-tixati.git
$ cd docker-tixati
$ docker build -t tixati --build-arg RELEASE=buster-slim .