Differences
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/21 12:55] – [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 118: | 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 133: | 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 image: | ||
| docker pull wxhere/ | docker pull wxhere/ | ||
| - | **Step 2**: create | + | **Step 2** Create a container and run it: |
| docker run -d \ | docker run -d \ | ||
| Line 160: | Line 189: | ||
| 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 171: | 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 | ||
