aria2.conf Configuration Generator
Create an optimized configuration file for aria2. Toggle options, tweak speeds, fetch high-speed BT trackers, enable RPC for Web GUIs, and download your ready-to-use aria2.conf file instantly.
Basic Settings
Connections & Limits
RPC & Remote Control (for AriaNg / WebUIs)
BitTorrent Settings & High-Speed Trackers
Where to put the generated aria2.conf
aria2 reads aria2.conf automatically from the user configuration path. Create the folder if it does not exist, save the file there, and restart aria2.
Linux / macOS
~/.aria2/aria2.conf
Windows
%USERPROFILE%\.aria2\aria2.conf
Not sure where a value goes?
Every option maps to an aria2c flag: for example max-connection-per-server=16 is the same as --max-connection-per-server=16. See the documentation for the most-used options, or the official manual for the full list.
Safe defaults and security
RPC secret is required
If you enable the RPC server, always set a strong rpc-secret. Never expose port 6800 to the public internet; keep it on localhost or a trusted LAN/VPN. For disk tuning, file-allocation=falloc is a good default on SSDs and modern filesystems, while none avoids preallocation entirely.
What each option does
Every key you generate maps 1:1 to an aria2c flag. These are the ones users change most.
| Key | Default | Effect |
|---|---|---|
dir | (current dir) | Folder where finished files are saved. |
max-concurrent-downloads | 5 | How many downloads run at once. |
max-connection-per-server | 1 | Sockets per host (up to 16). The biggest speed lever. |
split | 5 | File split into N parts downloaded in parallel. |
file-allocation | prealloc | How disk space is reserved: none, prealloc, trunc, falloc. |
max-overall-download-limit | 0 (unlimited) | Cap total download speed (e.g. 5M). |
max-overall-upload-limit | 0 (unlimited) | Cap total upload speed. |
enable-rpc / rpc-secret | off | Start the JSON-RPC server and protect it with a token. |
daemon | false | Run in the background (headless). |
seed-ratio | 1.0 | Stop seeding after this upload/download ratio (0 = forever). |
save-session / input-file | — | Persist the queue so downloads resume after a restart. |
bt-tracker | — | Comma-separated public trackers for BitTorrent. |
Need the full set? See the options reference or the official manual.
Which preset should I pick?
Max Speed / Gigabit
16 connections and splits, falloc allocation. Best on fast links and SSDs where you want maximum throughput.
NAS & Home Server
Daemon + RPC enabled, prealloc. A safe always-on baseline for a NAS or home server.
Minimal CLI
No daemon, no RPC, modest connections. For quick one-off downloads on a laptop.
Private Tracker (PT)
Seed ratio 0 (seed indefinitely) and the settings private sites expect. Remember to disable DHT/PEX if the tracker requires it.
Run aria2 with your config
aria2 reads aria2.conf from its default location automatically, or from any path you pass with --conf-path.
# Once: create the session file (aria2 refuses to start if it is missing) mkdir -p ~/.aria2 && touch ~/.aria2/aria2.session # Save the file, then run aria2 (it reads ~/.aria2/aria2.conf by default) aria2c # Or point it at a specific file aria2c --conf-path=/opt/aria2/aria2.conf # Daemon mode (background) if enabled in the config aria2c --conf-path=/opt/aria2/aria2.conf --daemon=true
A running RPC daemon can then be managed from the online WebUI or AriaNg.
Troubleshooting
aria2 says "option 'x' is not recognized"
You are on an older aria2 build, or a key has a typo. Check the key name against the options reference and update aria2.
The WebUI cannot connect after I used this config
Make sure enable-rpc=true, a non-empty rpc-secret, and rpc-listen-all=true (for LAN access) are present, then restart aria2. See the WebUI troubleshooting.
Downloads restart from zero after a reboot
Add save-session, input-file and save-session-interval, and keep continue=true. Ensure the session file lives in a persistent folder.
Which file-allocation mode should I use?
falloc on modern Linux/macOS filesystems, trunc where falloc is unsupported, none for flash, prealloc for maximum portability. See the speed guide.
Related resources
- Options reference — every key with examples
- Online WebUI — manage the daemon you just configured
- Tracker list — add BitTorrent trackers
- Speed optimization guide
- Troubleshooting