Install Web Based Download Utility with Aria2 WebUI on Debian/Ubuntu

Quick Setup

  1. Log into the Linux device
  2. Run the following commands in a terminal window
    # update software repositories
    sudo apt update
    # install available software updates
    sudo apt upgrade -y
    # install aria2
    sudo apt install aria2 -y
    # run the aria2 RPC server
    sudo aria2c --dir=/home/$USER/Downloads --enable-rpc=true --rpc-allow-origin-all=true --rpc-listen-all=true --rpc-listen-port=6800 --rpc-secret=SomethingSecure -D
    # install git
    sudo apt install git -y
    # make a working directory
    mkdir aria2-webui
    # clone the aria2 webui github repository
    git clone https://github.com/ziahamza/webui-aria2.git ./aria2-webui
  3. Open a file explorer and navigate to ~/aria2-webui/docs
  4. Double click index.html to open it in the default web browser
  5. Select Settings > Connection Settings from the top navigation menu
  6. Scroll down to the Enter the secret token field and paste the rpc-secret string, SomethingSecure in this example
  7. Scroll down and click the Save Connection configuration button
  8. The webui will now be able to communicate with aria2 over RPC

Starting Aria2 on System Boot

  1. Run the following commands in a terminal window
    # kill aria2 if it is running
    sudo killall aria2c
    # create aria2 conf directory
    sudo mkdir /etc/aria2 -p
    # create aria2.conf
    sudo nano /etc/aria2/aria2.conf
  2. Paste the following into the aria2.conf file

    dir=/home/i12bretro/Downloads
    enable-rpc=true
    rpc-allow-origin-all=true
    rpc-listen-all=true
    rpc-listen-port=6800
    rpc-secret=SomethingSecure

  3. Press CTRL+O, Enter, CTRL+X to write the changes to aria2.conf
  4. Continue with the following commands in terminal
    # create the service file
    sudo nano /etc/systemd/system/aria2.service
  5. Paste the following into the aria2.service file

    [Unit]
    Description=Aria2c
    Requires=network.target
    After=dhcpcd.service

    [Service]
    ExecStart=/usr/bin/aria2c --conf-path=/etc/aria2/aria2.conf

    [Install]
    WantedBy=default.target

  6. Press CTRL+O, Enter, CTRL+X to write the changes to aria2.service
  7. Continue with the following commands to start the new service on system boot
    # set the service to start on system boot
    sudo systemctl enable aria2
    # start the service now
    sudo systemctl start aria2
  8. Reboot the system
  9. Once the system comes back up, relaunch aria2-webui in a web browser and verify it can connect to the aria2 RPC server