Awesome Open Source
Awesome Open Source

Aria2 + AriaNg + Filebrowser

English | 简体中文

Docker Pulls Github Build


Page Views Count

If you like this project, please consider support me / 如果喜欢本项目,请考虑打赏,谢谢!

buy me a drink

One Docker image for file downloading, managing, sharing, as well as video playing and evening cloud storage synchronization.

Furthermore, it's pretty small and ARM CPU compatible which means you can also run it on Raspberry Pi🍓.

Last but not least, Auto HTTPS can't be more easy!

AriaNG Screenshot

File Browser File Browser


  • Aria2 (SSL support)
  • AriaNg
  • Rclone
  • File Browser: Files mangement and videos playing
  • Auto HTTPS (Let's Encrypt)
  • Bind non root user into container, so non root user can also manage downloaded files.
  • Basic Auth
  • Support ARM CPUs as well, all supported CPU platforms can be found here
  • Cloud Storage platforms synchronization

Recommended versions

  • wahyd4/aria2-ui:latest

Docker will pick the the proper ARCH for you. e.g. arm64v8 or x86_64

How to run

Quick run

  docker run -d --name aria2-ui -p 80:80 wahyd4/aria2-ui

Full features run

  docker run -d --name ariang \
  -p 80:80 \
  -p 443:443 \
  -e PUID=1000 \
  -e PGID=1000 \
  -e ENABLE_AUTH=true \
  -e RPC_SECRET=Hello \
  -e DOMAIN= \
  -e ARIA2_SSL=false \
  -e ARIA2_USER=user \
  -e ARIA2_PWD=password \
  -v /yourdata:/data \
  -v /app/a.db:/app/filebrowser.db \
  -v /to_yoursslkeys/:/app/conf/key \
  -v <conf files folder>:/app/conf \

Run with docker-compose

If you would like to get rid of those annoying command line commands, then just put the following sample content into docker-compose.yaml

version: "3.5"
    restart: unless-stopped
    image: wahyd4/aria2-ui:latest
      - ENABLE_AUTH=true
      - ARIA2_USER=hello
      - ARIA2_PWD=world
      - DOMAIN=
      - "80:80"
      - ./data:/data

Then simply run docker-compose up -d, that's it!

Supported Environment Variables

  • ENABLE_AUTH whether to enable Basic auth
  • ENABLE_RCLONE whether to disable Rclone, if you running this container offline or do not have stable connection to Github, please set to false
  • ARIA2_USER Basic Auth username, Rclone GUI uses it as well.
  • ARIA2_PWD Basic Auth password, Rclone GUI uses it as well.
  • ARIA2_EXTERNAL_PORT The Aria2 port which exposed to public to access to
  • PUID Bind Linux UID into container which means you can use non root user to manage downloaded files, default UID is 1000
  • PGID Bind Linux GID into container, default GID is 1000
  • RPC_SECRET The Aria2 RPC secret token
  • DOMAIN The domain you'd like to bind, when domain is a https:// thing, then auto TLS feature will be enabled
  • RCLONE_CONFIG_BASE64 Inject and config Rclone through base64 string, which is the only way to use Rclone on Heroku. Please use cat /app/conf/rclone.conf | base64 or any base64 online tools such as this to encode your rclone.conf as bse64 string. Note, you need to set ENABLE_RCLONE to true as well.

Supported Volumes

  • /data The folder contains all the files you download.

  • /app/conf/key The folder which stores Aria2 SSL certificate and key file. Notice: The certificate file should be named aria2.crt and the key file should be named aria2.key

  • /app/conf The Aria2 configuration and file session folder. Make sure you have aria2.conf and aria2.session file. For the first time aria2.session just need to be a empty file can be appended. You can also user the templates for these two file in the conf folder of this project. Please put your rclone.conf in this folder as well if you'd mount it to Rclone. So all the config files supported in this folder are:

    • aria2.conf
    • aria2.session
    • rclone.conf

    Warning: if you don't mount /app/conf, whenever the container restarts, you'll lose your downloading progress.

  • /app/filebrowser.db File Browser settings database, make sure you make a empty file first on your host.

Auto HTTPS enabling

Make sure you have added proper A record point to the host you running to your domain DNS record list, then just add e option to bind the https domain when you run the image

docker run -d --name aria2-ui -p 80:80 -p 443:443 -e DOMAIN= wahyd4/aria2-ui

Build the image by yourself

 docker buildx build --platform linux/arm/v7,linux/arm64,linux/amd64 -t aria2-ui .

Docker Hub

Usage it in Docker compose

Please refer


  1. When you running the docker image with non 80 port or you have HTTPS enabled, you will meet the error says Aria2 Status Disconnected, then you will need to set ARIA2_EXTERNAL_PORT and recreate your container.
  2. If there is no speed at all when you downloading a BitTorrent file, please try to use a popular torrent file first to help the application to cache DHT file. Then the speed should get fast and fast, as well as downloading other links.
  3. If you see any errors related to setcap which probably means the Linux you are running doesn't support running this application with non-root user. So please specify the PUID and PGID to 0 explicitly to use root user to run it.
  4. How can I get Rclone authenticated? Due to Rclone is running in this docker image only as a component rather than an application, you can only interact with it via /rclone endpoint, and no other ports. So the web browser authentication mechanism doesn't work here. Please configure Rclone through command line within the container. You can follow the official doc Configuring rclone on a remote / headless machine or this issue

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Shell (226,222
Raspberry Pi (7,390
Arm (1,401
Rclone (157
Aria (137
Related Projects