qBittorrent is a trusted and safe torrent client, widely recognized for its lightweight design and reliability. Developed as an open-source alternative to µTorrent, it has received extensive positive feedback from users since its release.
In this step-by-step guide, you’ll learn how to install qBittorrent on your UGREEN NAS using Docker and Portainer, ensuring a smooth and efficient setup.
Follow this step-by-step guide to install and configure qBittorrent on your UGREEN NAS with Docker and Portainer. Ensure that all prerequisites are met and each step is completed carefully.
Step 1: Install Portainer
If you haven’t installed Portainer yet, follow this step-by-step guide. If Portainer is already installed on your UGREEN NAS, you can skip this step.
Note: Ensure you have installed the latest version of Portainer.
Step 2: Add Read & Write Permissions to the Docker Folder
If you’ve already configured read and write permissions for the Docker folder, skip this step. Otherwise, ensure the permissions are correctly set before proceeding.
Step 3: Create a Folder for qBittorrent
- Open File Manager on your UGREEN NAS.
- Navigate to the
docker
folder. - Inside the
docker
folder, create a new folder named qbittorrent.
Note: Use only lowercase letters when naming the folder.
Refer to the image below for guidance.
Step 4: Create Config and Downloads Folders
- Open the qbittorrent folder you created in Step 3.
- Create two new subfolders named:
config
downloads
Note: Use only lowercase letters for the folder names.
Refer to the image below for assistance.
Step 5: Log Into Portainer
- Open Portainer and log in with your credentials.
- In the left-hand menu, click Stacks and then click + Add stack.
Step 6: Configure the Stack
- In the Name field, type
qbittorrent
- Copy and paste the following code into the Web editor:
services:
qbittorrent:
container_name: qBittorrent
image: ghcr.io/linuxserver/qbittorrent
healthcheck:
test: curl -f http://localhost:9865/ || exit 1
mem_limit: 6g
cpu_shares: 768
security_opt:
- no-new-privileges:true
network_mode: host
tty: true
restart: on-failure:5
ports:
- 6881:6881
- 6881:6881/udp
- 9865:9865
volumes:
- /volume1/docker/qbittorrent/config:/config:rw
- /volume1/docker/qbittorrent/downloads:/downloads:rw
environment:
WEBUI_PORT: 9865
PUID: 1000
PGID: 10
TZ: Europe/Bucharest
Important Notes:
- Replace the
PUID
andPGID
values with your own user and group ID numbers. Follow this guide to find your PUID and PGID. - Update the
TZ
value with your current time zone. Refer to this list of time zones.
Step 7: Deploy the Stack
- Scroll down and click the Deploy the stack button.
The installation may take a few minutes depending on your internet speed.
When the deployment is successful, you’ll see the message “Success Stack successfully deployed” in the top-right corner of your screen.
Step 8: Verify the Deployment
- In the left-hand menu, click Containers.
- Locate the qBittorrent container and click the log icon.
- Copy the temporary password from the logs.
Step 9: Access qBittorrent Web Interface
- Open your browser and enter:
http://<ugreen-nas-ip-address>:9865
- Use the default username admin and the temporary password you copied in Step 8 to log in.
Warning: The default username is admin.
Step 10: Update Your Credentials
- Once logged in, click the Settings icon.
- Navigate to the Web UI tab.
- In the Authentication section, update your username and password with your own credentials.
- Scroll down and click Save.
From now on, use your new username and password to access qBittorrent.
Step 11: Start Downloading
Your qBittorrent setup is now complete! You can begin downloading and managing torrents on your UGREEN NAS.
Enjoy using qBittorrent on your UGREEN NAS! Let me know if you have any questions or need additional assistance.