This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
bitcomet_installation_guide_for_linux [2024/03/12 14:30] – [Docker image] wxhere | bitcomet_installation_guide_for_linux [2024/12/17 03:08] (current) – wxhere | ||
---|---|---|---|
Line 32: | Line 32: | ||
</ | </ | ||
- | ==== ==== | ||
**Step 2** Download BitComet | **Step 2** Download BitComet | ||
Line 39: | Line 38: | ||
**Step 3** Make AppImage executable and run it | **Step 3** Make AppImage executable and run it | ||
- | == Using the GUI == | + | === Using the GUI === |
- Open your file manager and browse to the location of the AppImage | - Open your file manager and browse to the location of the AppImage | ||
Line 47: | Line 46: | ||
- Double-click on the AppImage file to run | - Double-click on the AppImage file to run | ||
- | == Using the Terminal == | + | === Using the Terminal |
- Open a terminal | - Open a terminal | ||
Line 54: | Line 53: | ||
- Run the AppImage: < | - Run the AppImage: < | ||
- | ==== ==== | + | ===== |
**Step 4** Install missing libraries if failed to run AppImage (distro-specific) | **Step 4** Install missing libraries if failed to run AppImage (distro-specific) | ||
Line 64: | Line 63: | ||
- Install the missing libraries based on the error message: | - Install the missing libraries based on the error message: | ||
- | == For Ubuntu / Debian distros == | + | === For Ubuntu / Debian distros |
^ Library ^ commands to check installed version and install missing library ^ | ^ Library ^ commands to check installed version and install missing library ^ | ||
Line 70: | Line 69: | ||
| libwebkit2gtk-4.0 | apt list < | | libwebkit2gtk-4.0 | apt list < | ||
- | == For Fedora / RedHat / CentOS distros == | + | **Note:** For Ubuntu 24.04 and above distros, the apt sources for 22.04 are required |
+ | < | ||
+ | # add " | ||
+ | # add " | ||
+ | # 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 ^ | ^ Library ^ commands to check installed version and install missing library ^ | ||
Line 76: | Line 85: | ||
| libwebkit2gtk-4.0 | yum list webkit2gtk* \\ sudo yum install webkit2gtk-4.0.x86_64 | | | libwebkit2gtk-4.0 | yum list webkit2gtk* \\ sudo yum install webkit2gtk-4.0.x86_64 | | ||
- | == For openSUSE distros == | + | === For openSUSE distros |
^ Library ^ commands to check installed version and install missing library ^ | ^ Library ^ commands to check installed version and install missing library ^ | ||
Line 84: | Line 93: | ||
More info about errors related to something called “FUSE” can be found at [[https:// | More info about errors related to something called “FUSE” can be found at [[https:// | ||
- | ===== Docker image ===== | + | ===== Deb package |
- | List of BitComet | + | **Step 1** Download |
- | === Deploy Method 1: using docker-compose=== | + | the deb package of BitComet Linux edition can be downloaded from [[https:// |
- | **Step | + | **Step |
+ | |||
+ | - Open a terminal | ||
+ | - Change to the directory containing the deb file, e.g., using < | ||
+ | - Install the deb package:< | ||
+ | |||
+ | **Step 3** Start the program | ||
+ | |||
+ | launch the main program of GUI mode: < | ||
+ | launch the main program of console mode with Web UI: < | ||
+ | |||
+ | **Note: **The main program in both modes can only run one instance at a time. | ||
+ | |||
+ | ===== Docker image (GUI mode) ===== | ||
+ | |||
+ | List of BitComet Docker images in GUI mode: https:// | ||
+ | |||
+ | ==== Deploy Method 1: using docker-compose ==== | ||
+ | |||
+ | **Step 1** Save **docker-compose.yml** to your local system: | ||
version: ' | version: ' | ||
Line 96: | Line 124: | ||
sandbox: | sandbox: | ||
container_name: | container_name: | ||
- | image: wxhere/ | + | image: wxhere/ |
volumes: | volumes: | ||
# mounts a host directory into the container to store config files | # mounts a host directory into the container to store config files | ||
Line 103: | Line 131: | ||
- ~/ | - ~/ | ||
ports: | ports: | ||
- | # VNC GUI client | + | # VNC GUI port |
- 5900:5900 | - 5900:5900 | ||
- | # Web GUI client | + | # Web GUI port |
- 6080:80 | - 6080:80 | ||
+ | # BitTorrent ports | ||
+ | - 6082:6082 | ||
+ | - 6082: | ||
environment: | environment: | ||
- VNC_PASSWORD=123456 | - VNC_PASSWORD=123456 | ||
Line 115: | Line 146: | ||
Note: Please change the username, password, and port mapping according to your own needs. | Note: Please change the username, password, and port mapping according to your own needs. | ||
- | **Step 2**: pull docker image, create container and run: | + | **Step 2** Pull the docker image, create |
docker-compose -f docker-compose.yml up | docker-compose -f docker-compose.yml up | ||
- | **Step 3**: open webpage of BitComet GUI in your browser: | + | **Step 3** Open the webpage of BitComet GUI in your browser: |
http:// | http:// | ||
Line 130: | Line 161: | ||
username: sandbox | username: sandbox | ||
password: 123456 | password: 123456 | ||
- | **Step 4**: click the BitComet icon in desktop to launch it. | ||
- | === Deploy Method 2: using Docker CLI === | + | **Step 4** Click the BitComet icon in desktop to launch it if closed. |
- | **Step 1**: pull docker image: | + | ==== Deploy Method 2: using Docker CLI ==== |
- | | + | **Step 1** Pull the docker |
- | **Step 2**: create | + | docker pull wxhere/ |
+ | |||
+ | **Step 2** Create a container and run it: | ||
docker run -d \ | docker run -d \ | ||
- | --name=bitcomet-2.7.0 | + | --name=bitcomet \ |
-e VNC_PASSWORD=123456 \ | -e VNC_PASSWORD=123456 \ | ||
-e HTTP_PASSWORD=123456 \ | -e HTTP_PASSWORD=123456 \ | ||
Line 153: | Line 185: | ||
-v ~/ | -v ~/ | ||
--restart unless-stopped \ | --restart unless-stopped \ | ||
- | wxhere/ | + | wxhere/ |
| | ||
Note: Please change the username, password, and port mapping according to your own needs. | Note: Please change the username, password, and port mapping according to your own needs. | ||
- | **Step 3**: open webpage of BitComet GUI in your browser: | + | **Step 3** Open the webpage of BitComet GUI in your browser: |
http:// | http:// | ||
Line 168: | Line 200: | ||
username: sandbox | username: sandbox | ||
password: 123456 | password: 123456 | ||
- | **Step 4**: click the BitComet icon in desktop to launch it. | + | |
+ | **Step 4** Click the BitComet icon in desktop to launch it if closed. | ||
+ | |||
+ | ===== Docker image (Web UI mode) ===== | ||
+ | |||
+ | List of BitComet Docker images in Web UI mode: https:// | ||
+ | |||
+ | ==== Deploy Method 1: using docker-compose ==== | ||
+ | |||
+ | **Step 1** Save **docker-compose.yml** to your local system: | ||
+ | |||
+ | services: | ||
+ | sandbox: | ||
+ | container_name: | ||
+ | image: wxhere/ | ||
+ | volumes: | ||
+ | # mounts a host directory into the container to store config files | ||
+ | - / | ||
+ | # mounts a host directory into the container to store downloaded files | ||
+ | - ~/ | ||
+ | ports: | ||
+ | # Web GUI port | ||
+ | - 6080:8080 | ||
+ | # BitTorrent port | ||
+ | - 6082:6082 | ||
+ | - 6082: | ||
+ | environment: | ||
+ | - BITCOMET_WEBUI_PORT=8080 | ||
+ | - BITCOMET_BT_PORT=6082 | ||
+ | - WEBUI_USERNAME=test | ||
+ | - WEBUI_PASSWORD=test | ||
+ | |||
+ | Note: Please change the username, password, and port mapping according to your own needs. | ||
+ | |||
+ | **Step 2** Pull the docker image, create a container and run it: | ||
+ | |||
+ | docker-compose -f docker-compose.yml up | ||
+ | |||
+ | **Step 3** Open the webpage of BitComet Web UI in your browser: | ||
+ | |||
+ | http:// | ||
+ | username: test | ||
+ | password: test | ||
+ | |||
+ | ==== Deploy Method 2: using Docker CLI ==== | ||
+ | |||
+ | **Step 1** Pull the docker image: | ||
+ | |||
+ | docker pull wxhere/ | ||
+ | |||
+ | **Step 2** Create a container and run it: | ||
+ | |||
+ | docker run -d \ | ||
+ | --name=bitcomet \ | ||
+ | -e BITCOMET_WEBUI_PORT=8080 \ | ||
+ | -e BITCOMET_BT_PORT=6082 \ | ||
+ | -e WEBUI_USERNAME=test \ | ||
+ | -e WEBUI_PASSWORD=test \ | ||
+ | -p 6080:8080 \ | ||
+ | -p 6882:6882 \ | ||
+ | -p 6882: | ||
+ | -v / | ||
+ | -v ~/ | ||
+ | --restart unless-stopped \ | ||
+ | wxhere/ | ||
+ | |||
+ | Note: Please change the username, password, and port mapping according to your own needs. | ||
+ | |||
+ | **Step 3** Open the webpage of BitComet Web UI in your browser: | ||
+ | |||
+ | http:// | ||
+ | username: test | ||
+ | password: test |