1. Home
  2. Knowledge Base
  3. How to Install qBittorrent on a UGREEN NASSync Device using Docker & Portainer

How to Install qBittorrent on a UGREEN NASSync Device using Docker & Portainer

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

  1. Open File Manager on your UGREEN NAS.
  2. Navigate to the docker folder.
  3. 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

  1. Open the qbittorrent folder you created in Step 3.
  2. 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

  1. Open Portainer and log in with your credentials.
  2. In the left-hand menu, click Stacks and then click + Add stack.

Step 6: Configure the Stack

  1. In the Name field, type
    qbittorrent
  2. 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 and PGID 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

  1. 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

  1. In the left-hand menu, click Containers.
  2. Locate the qBittorrent container and click the log icon.
  3. Copy the temporary password from the logs.

Step 9: Access qBittorrent Web Interface

  1. Open your browser and enter:
    http://<ugreen-nas-ip-address>:9865
  2. 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

  1. Once logged in, click the Settings icon.
  2. Navigate to the Web UI tab.
  3. In the Authentication section, update your username and password with your own credentials.
  4. 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.

Was this article helpful?