selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
aria2-ariang-docker logo

Self-host aria2-ariang-docker

v6.4.0

All-in-one download manager with Aria2, AriaNg, File Browser

ReleaseOpen SourceApache-2.0
Updated11 months ago
LanguageShell
Setup difficultyEasy
Stars
1 121
Ports
80 (HTTP web UI (AriaNg, File Browser, Rclone UI)), 443 (HTTPS web UI (auto TLS via Caddy)), 6881 (BitTorrent DHT/peer port)
Docker
wahyd4/aria2-ui
Install with Docker
AriaNg web UI showing download management interfaceFile Browser interface for file management and video playback

What is aria2-ariang-docker?

aria2-ariang-docker packages Aria2 (multi-protocol downloader), AriaNg (web frontend), File Browser (file manager with video playback), and Rclone (cloud storage sync) into a single multi-arch Docker image. It targets home-server and homelab users who want a complete download-and-manage stack. Key capabilities include Basic Auth, automatic Let's Encrypt HTTPS via Caddy, non-root user mapping (PUID/PGID), and optional auto-upload to cloud providers after downloads finish. The image runs on linux/amd64, linux/arm64, and linux/arm/v7 (Raspberry Pi). Deployment options are a one-line docker run, a docker-compose file, or a Kubernetes manifest. Configuration is done through environment variables for auth, RPC secret, domain, and Rclone settings. No external database or cache is required — everything runs inside the container. The project is actively maintained with recent releases (v6.4.0 in Nov 2025) and uses the Apache-2.0 license.

Should you self-host aria2-ariang-docker?

aria2-ariang-docker scores 58/100 on selfhost.directory (how scoring works) and ranks #17 of 45 in Download Management. It has 1 121 GitHub stars.

It shipped 2 stable releases in the past year. The latest, v6.4.0, came out on 28 November 2025. New versions land roughly every 4 weeks.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Shell.

Its closest alternative on selfhost.directory is cobalt (83/100, 45 582 stars). It scores higher overall, so compare the two before you pick. See aria2-ariang-docker vs cobalt side by side.

Features

  • ARM architecture support
  • Automatic HTTPS
  • Auto-upload to cloud after download
  • Basic Authentication
  • Cloud storage synchronization
  • Download automation via Shortcuts
  • File manager with video playback
  • Multi-protocol downloader
  • Non-root user mapping
  • Web UI for Aria2

aria2-ariang-docker README

How to install aria2-ariang-docker

Install aria2-ariang-docker with Docker

Docker Engine
Environment variables
ENABLE_AUTH, ARIA2_USER, ARIA2_PWD, RPC_SECRET, DOMAIN, PUID, PGID, etc.

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

Quick run on port 8000

How to configure aria2-ariang-docker

  • ARIA2_EXTERNAL_PORT80The Aria2 port which exposed to public to access to

    The Aria2 port which exposed to public to access to

  • ARIA2_PWDpasswordBasic Auth password, Rclone GUI uses it as well

    Basic Auth password, Rclone GUI uses it as well

  • ARIA2_USERuserBasic Auth username, Rclone GUI uses it as well

    Basic Auth username, Rclone GUI uses it as well

  • CADDY_LOG_LEVELINFOLog level of Caddy

    Log level of Caddy

    values: DEBUG, INFO, WARN, ERROR

  • DOMAIN:80The domain to bind; when https:// auto TLS is enabled

    The domain to bind; when https:// auto TLS is enabled

  • ENABLE_APP_CHECKERtrueCheck for new docker image version daily

    Check for new docker image version daily

    values: true, false

  • ENABLE_AUTHfalseWhether to enable Basic auth

    Whether to enable Basic auth

    values: true, false

  • ENABLE_FILEBROWSERtrueWhether to disable Filebrowser

    Whether to disable Filebrowser

    values: true, false

  • ENABLE_RCLONEtrueWhether to disable Rclone

    Whether to disable Rclone

    values: true, false

  • FIX_DATA_VOLUME_PERMISSIONSfalseRun chown against /data folder with PUID/PGID

    Run chown against /data folder with PUID/PGID

    values: true, false

  • PGID1000Bind Linux GID into container

    Bind Linux GID into container

  • PUID1000Bind Linux UID into container for non-root file management

    Bind Linux UID into container for non-root file management

  • RCLONE_AUTO_UPLOAD_FILE_MAX_SIZE100GMaximum file size for auto uploader

    Maximum file size for auto uploader

  • RCLONE_AUTO_UPLOAD_FILE_MIN_SIZE1KMinimum file size for auto uploader

    Minimum file size for auto uploader

  • RCLONE_AUTO_UPLOAD_PROVIDERRclone remote storage provider name for auto-upload

    Rclone remote storage provider name for auto-upload

  • RCLONE_AUTO_UPLOAD_REMOTE_PATH/downloadsFile folder in remote cloud storage provider

    File folder in remote cloud storage provider

  • RCLONE_CONFIG_BASE64Inject and config Rclone through base64 string

    Inject and config Rclone through base64 string

  • RPC_SECRETThe Aria2 RPC secret token

    The Aria2 RPC secret token

aria2-ariang-docker releases & version history

FAQ

What do I do if I see setcap errors?

Your Linux kernel doesn't support non-root capabilities; set PUID=0 and PGID=0 to run as root.

Why is there no download speed for BitTorrent files?

Download a popular torrent first to populate the DHT cache, then speeds will improve for other downloads.

Why do I get 'Aria2 Status Disconnected' when using a non-80 port or HTTPS?

Set the ARIA2_EXTERNAL_PORT environment variable to the external port and recreate the container.

More in File Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…