🟢 Setup Aria2 + AriaNg — Multi-Protocol Download Manager
Deploy Aria2 with the AriaNg web UI on Ubuntu — a lightweight engine that downloads over HTTP, FTP, BitTorrent, and Metalink with multi-connection speed.
📦 Resources & Setup Scripts
Grab the automated bash script from GitHub to follow along with the video.
Quick Install:
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/downloads/aria2/aria2-ubuntu.sh
chmod +x aria2-ubuntu.sh
sudo bash aria2-ubuntu.shTutorial Steps
1 Download the Script
wget https://raw.githubusercontent.com/mhmdali94/Docker/main/downloads/aria2/aria2-ubuntu.sh2 Make it Executable
chmod +x aria2-ubuntu.sh3 Run the Installer
The script installs Docker if needed, generates a random 24-character RPC secret, and starts the hurlenko/aria2-ariang container with config and downloads volumes under /root/docker/aria2.
sudo bash aria2-ubuntu.sh4 Access the Web UI
Open AriaNg in your browser, then enter the RPC secret from the install output under AriaNg Settings → RPC:
http://<your-server-ip>:8119Ports Used
| Port | Purpose |
|---|---|
| 8119 | AriaNg Web UI (container port 8080) |
| 6800 | aria2 JSON-RPC API |
Overview
Aria2 is a lightweight command-line download engine that speaks four protocol families — HTTP(S), FTP/SFTP, BitTorrent, and Metalink — and can split a single file across up to 16 connections to saturate your line. AriaNg is the polished single-page web UI that drives it over the JSON-RPC API. This setup runs the hurlenko/aria2-ariang image, which bundles both: AriaNg on port 8119 and the aria2 RPC endpoint on port 6800, protected by a random 24-character secret the install script generates. Config persists in /aria2/conf and completed files in /aria2/data, stored under /root/docker/aria2 on the host.
Why Use It
Aria2 fills the gap the torrent-only and YouTube-only tools leave open: plain big-file downloads. Where wget uses one connection, aria2 opens many in parallel and can even pull the same file from multiple mirrors simultaneously — often several times faster on throttled or distant servers. It idles at a few megabytes of RAM, resumes interrupted downloads, and its RPC API means browsers extensions, scripts, and AriaNg can all hand it work. One small container covers direct links, FTP servers, magnet links, and Metalinks alike.
When You Need It
Who Should Use It
Real Use Cases
Main Features
How to Use After Installation
Security Best Practices
Ports and Firewall Notes
Two ports are published: 8119 serves the AriaNg web UI (container port 8080), and 6800 is aria2's JSON-RPC endpoint that AriaNg and browser extensions talk to. The script opens both in UFW. Neither should face the internet: AriaNg is unauthenticated and the RPC port is protected only by the secret token. For BitTorrent duty aria2 also uses outbound peer connections; no inbound peer port is opened by default, which limits torrent connectability but keeps the firewall surface minimal.
Backup and Maintenance
Common Mistakes
Troubleshooting
Alternatives
For serious BitTorrent work with seeding, categories, and RSS automation, qBittorrent or Transmission (both in this Academy) are the right tools. For YouTube and streaming-site downloads, MeTube wraps yt-dlp with a similar paste-a-link workflow. Motrix is a desktop app built on aria2 if you prefer a local client, and plain wget/curl remain fine for small single-connection fetches.
When Not to Use It
If torrents are your main workload — long-term seeding, private trackers, ratio management — use qBittorrent; aria2's BitTorrent support is functional but minimal. For video-platform downloads that need extractors (YouTube, TikTok), aria2 cannot parse the pages — that is MeTube/yt-dlp territory. And for one small file now and then, wget on the CLI is less setup than a persistent daemon.
PrismaTechWork Professional Help
PrismaTechWork provides end-to-end infrastructure services — from initial deployment and security hardening to ongoing monitoring, automated backups, and dedicated support.
Frequently Asked Questions
AriaNg says 'Disconnected' — what do I do?
AriaNg needs the RPC secret to talk to aria2. Open AriaNg Settings → RPC, paste the 24-character secret printed by the install script into 'Aria2 RPC Secret Token', and reload the page. If you lost it, read it back with docker inspect aria2 | grep RPC_SECRET.
How is aria2 faster than wget or a browser download?
aria2 splits a file into segments and downloads them over multiple parallel connections (up to 16 per server), then reassembles it. On servers that throttle per connection, this multiplies your effective speed. It can also pull the same file from several mirrors at once via Metalink.
Can aria2 download torrents?
Yes — it handles .torrent files and magnet links with DHT and PEX support. It is fine for grabbing a well-seeded torrent occasionally, but for ongoing seeding, private trackers, and rich management, a dedicated client like qBittorrent is the better tool.
Where do finished downloads go?
Into the /aria2/data volume, which the script maps to /root/docker/aria2/downloads on the host. You can organize further with per-download directory options in AriaNg's New Download dialog.
Can my browser send downloads to aria2 automatically?
Yes. Extensions such as Aria2 Explorer (Chrome) or Aria2 Integration (Firefox) intercept downloads and forward them to your RPC endpoint at http://your-server:6800/jsonrpc with the secret token. Your PC then never handles the file — the server does.