Home

A free C++ BitTorrent/HTTP/FTP Download Client

bitcomet_installation_guide_for_linux
 

BitComet Installation Guide for Linux

BitComet Linux Edition is packaged using AppImage format and Docker image.

AppImage package

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

Using the GUI

  1. Open your file manager and browse to the location of the AppImage
  2. Right-click on the AppImage and click the ‘Properties’ entry
  3. Switch to the Permissions tab and click the ‘Allow executing file as program’ checkbox
  4. Close the dialog
  5. Double-click on the AppImage file to run

Using the Terminal

  1. Open a terminal
  2. Change to the directory containing the AppImage, e.g., using
     cd <my directory> 
  3. Make the AppImage executable:
    chmod +x BitComet.AppImage
  4. Run the 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.

  1. Open a terminal
  2. Change to the directory containing the AppImage, e.g., using
     cd <my directory> 
  3. Try to run the AppImage again:
    ./BitComet.AppImage
  4. Install the missing libraries based on the error message:

For Ubuntu / Debian distros

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

For Fedora / RedHat / CentOS distros

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

For openSUSE distros

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

Docker image

List of BitComet docker images: https://hub.docker.com/r/wxhere/bitcomet/tags

Deploy Method 1: using docker-compose

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.

Deploy Method 2: using Docker CLI

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.

 
bitcomet_installation_guide_for_linux.txt · Last modified: 2024/11/22 08:44 by wxhere
Recent changes RSS feed Driven by DokuWiki