Webui-Aria2, web interface for the download accelerator Aria2

5th Mar 2017 Karibu

Several years ago, download managers and accelerators were pretty popular, especially on Windows. Nowadays, we still use them but though web browser extensions (like downthemall), etc..

The idea is to cut one file in several chunks and to download several chunks at one time. This enable multi-connections to the same server. But it also allow us to manage those files (Play/Pause/Resume, multi sources / mirrors for a same file, etc..).

This is basically to maximize the bandwidth and force some bottlenecks (From the client or the server).

On Linux, the most popular way to download a file in command line is with wget, but if you need an accelerator (multi chunks, multi servers, torrents,…), wget can’t help. However you will be able to do it with Aria2, which is probably the most popular (and powerful) accelerator on Linux.

I’ve been using it quite often and always been very satisfied. That is why I wanted to present you Aria2WebUI, a web interface to manage your aria2 instance.

Aria2WebUI is very simple to install and will let you manage your aria2 remotely in a fancy web interface. You will be able to add files or torrents to download (From multi sources as well) and even download them back with your web browser.


I’m sure you have faced many situations where such app would have helped your life. Just last week, I wanted to download a torrent from a hotel connection and it was very slow (but usual HTTP worked very fast). This tool helped me to get the ISO I wanted in a very short time then.

So let’s see how to install it on Debian. (Installation steps for others flavors should be similar)



1) Install aria2

Obviously, you will first need aria2. Run in root (or with sudo):

apt-get install aria2
2) Clone the webui-aria2 git repo in your /var/www

Still in root, run

cd /var/www
git clone https://github.com/ziahamza/webui-aria2


3) Run aria2 as a daemon

You will need to launch aria2 in background and to listen to incoming connections. But to avoid anyone else using your aria2 instance, we will first generate a random token.

openssl rand -base64 32

Then copy this token and launch aria2:

aria2c --enable-rpc --rpc-listen-all --daemon --rpc-secret=mysupertoken

with mysupertoken being the generated token.


4) Update webui configuration

As you have launched aria2 with a token, you need to configure the webui to use it to connect to the daemon.

Still in root, run:

nano /var/www/webui-aria2/configuration.js

then uncomment the line “token:” and add your token.


And that’s it, you should now be able to go to http://yourIP/webui-aria2 and access to the web interface.

You might want to create a dedicated virtualhost (to use aria.mydomain.com instead) and add a login/password to access to the web interface.


If you want to know more about Webui-Aria2, I strongly suggest you to check their git page. (Quite a lot of info about this app)


Loves to discover web-based apps to install on his own server@home and write articles about it


Add a comment