BitComet Linux Edition is packaged using AppImage format and Docker image.
The AppImage package can run the application without needing superuser permissions to install it. The detailed info about AppImage format can be found at https://www.appimage.org/
Step 1 Check Linux Distro Version (optional)
Linux Distro | Supported Version |
---|---|
Ubuntu | 18.04 |
Debian | 12.1 |
Fedora | 38 |
openSUSE | Leap 15.5 / Tumbleweed |
CentOS | Stream 9 |
Others | GLIBCXX_3.4.22 or higher |
The only requirement to run BitComet in your Linux distro is the GLIBCXX version in libstdc++.so.
BitComet cannot run if the GLIBCXX version in your Linux distro is lower than GLIBCXX_3.4.22
The version of installed GLIBCXX in your Linux distro can be find by following commands:
# find libstdc++.so.6 file find /usr/ -name libstdc++.so.6 # get GLIBCXX version, typically using strings /usr/lib/x86_64-linux-gnu/libstdc++.so.6 | grep GLIBCXX # or using strings /usr/lib64/libstdc++.so.6 | grep GLIBCXX
Step 2 Download BitComet
The AppImage file of BitComet Linux edition can be downloaded from the official website.
Step 3 Make AppImage executable and run it
cd <my directory>
chmod +x BitComet.AppImage
./BitComet.AppImage
Step 4 Install missing libraries if failed to run AppImage (distro-specific)
If your Linux distro doesn't contain some necessary libraries that BitComet depends on, please try to install them manually.
cd <my directory>
./BitComet.AppImage
Library | commands to check installed version and install missing library |
---|---|
libfuse2 | apt list | grep libfuse sudo apt install libfuse2 |
libwebkit2gtk-4.0 | apt list | grep libwebkit2gtk sudo apt install libwebkit2gtk-4.0-37 |
Note: For Ubuntu 24.04 and above distros, the apt sources for 22.04 are required
sudo nano /etc/apt/sources.list.d/ubuntu.sources # add "jammy" to the end of line "Suites: xxx xxx xxx" # add "jammy-security" to the end of line "Suites: xxx-security" # save and quit sudo apt update sudo apt install libwebkit2gtk-4.0-37 # revert apt sources if necessary
Library | commands to check installed version and install missing library |
---|---|
libfuse2 | yum list fuse* sudo yum –enablerepo=epel install fuse-sshfs sudo usermod -a -G fuse $(whoami) |
libwebkit2gtk-4.0 | yum list webkit2gtk* sudo yum install webkit2gtk-4.0.x86_64 |
Library | commands to check installed version and install missing library |
---|---|
libfuse2 | zypper search -i libfuse sudo zypper install fuse libfuse2 |
libwebkit2gtk-4.0 | zypper search -i webkit2gtk sudo zypper install webkit2gtk-4_0-37 |
More info about errors related to something called “FUSE” can be found at this page
List of BitComet docker images: https://hub.docker.com/r/wxhere/bitcomet/tags
Step 1: save docker-compose.yml to your local system:
version: '3' services: sandbox: container_name: bitcomet image: wxhere/bitcomet:latest volumes: # mounts a host directory into the container to store config files - /docker/appdata/BitComet:/home/sandbox/.config/BitComet:rw # mounts a host directory into the container to store downloaded files - ~/Downloads:/home/sandbox/Downloads:rw ports: # VNC GUI port - 5900:5900 # Web GUI port - 6080:80 # BitTorrent ports - 6082:6082 - 6082:6082/udp environment: - VNC_PASSWORD=123456 - HTTP_PASSWORD=123456 - USER=sandbox - PASSWORD=123456
Note: Please change the username, password, and port mapping according to your own needs.
Step 2: pull docker image, create container and run:
docker-compose -f docker-compose.yml up
Step 3: open webpage of BitComet GUI in your browser:
http://127.0.0.1:6080 username: sandbox password: 123456
or connect to the VNC desktop with your VNC client:
port: 5900 username: sandbox password: 123456
Step 4: click the BitComet icon in desktop to launch it.
Step 1: pull docker image:
docker pull wxhere/bitcomet:latest
Step 2: create container and run:
docker run -d \ --name=bitcomet \ -e VNC_PASSWORD=123456 \ -e HTTP_PASSWORD=123456 \ -e USER=sandbox \ -e PASSWORD=123456 \ -p 5900:5900 \ -p 6080:80 \ -p 6882:6882 \ -p 6882:6882/udp \ -v /docker/appdata/BitComet:/home/sandbox/.config/BitComet:rw \ -v ~/Downloads:/home/sandbox/Downloads:rw \ --restart unless-stopped \ wxhere/bitcomet:latest
Note: Please change the username, password, and port mapping according to your own needs.
Step 3: open webpage of BitComet GUI in your browser:
http://127.0.0.1:6080 username: sandbox password: 123456
or connect to the VNC desktop with your VNC client:
port: 5900 username: sandbox password: 123456
Step 4: click the BitComet icon in desktop to launch it.