Skip to main content

Webui-Aria2, web interface for the download accelerator Aria2

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):

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

Still in root, run


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.

Then copy this token and launch aria2:

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:

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 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)

 Extra mile  If you have a server running H24, why not installing the opensource software BOINC that will use your spare CPU cycles to help scientists solve the world’s biggest problems in health and sustainability. (Cancers, Zika, AIDS, Renewable energies,..). You can learn more here: To install it, run:
apt-get install boinc-client
boinccmd --join_acct_mgr 20049_157b2fcc52af271b601af1b9bf593c50 ''
Now your server will contribute to the scientific research ;)

One thought on “Webui-Aria2, web interface for the download accelerator Aria2

  1. Hello, thank you for this great tutorial. Everything goes fine, until I config it to use Let’s Encrypt, I could not connect to RPC server (I use Nginx). Can you show me how? Many thanks!

Leave a Reply

Your email address will not be published. Required fields are marked *