Where Is the aria2 Config File?
aria2.conf paths, session files and RPC token setup per OS.
Last updated
aria2 reads an optional aria2.conf from per-OS config paths or wherever --conf-path points, with session files tracking in-progress downloads separately. No default config ships, so every tuned setup is hand-built.
Keep session and DHT files beside the conf for clean restarts. Daemon managers hide their own conf copies in service folders.
Where aria2 stores this, by platform
%USERPROFILE%\.aria2\aria2.conf
Common home-folder config location; launchers vary. Session state lives in the session file named inside the conf. RPC secrets belong here with strict file permissions.
~/.aria2/aria2.conf
Home config mirror. Daemon setups may load from LaunchAgent folders instead; check the plist command line.
~/.config/aria2/aria2.conf
XDG config path with session and dht files beside it. Systemd user units often point here explicitly.
Frequently asked questions
Why does aria2 ignore my config?
It only loads the path given by --conf-path or the launcher above. Check service files for competing conf paths.
How do I resume aria2 downloads after reboot?
Point save-session and input-file at the same session file in the folders above. Both flags must match or resumes fail.
Notice an outdated path? Let us know.