Commands.page Logo

How to Enable Verbose Logging in Aria2 on Ubuntu

This guide explains how to activate detailed logging for the aria2 download utility on Ubuntu systems. When downloads fail or behave unexpectedly, standard output often lacks the necessary details to identify the root cause. By enabling verbose mode, users can gain insight into connection handshakes, server responses, and internal errors, making troubleshooting significantly more efficient.

To enable verbose logging in aria2, use the --verbose flag or its shorthand -V. This command forces aria2 to print detailed debug information to the console during the download process. It is particularly useful when diagnosing connectivity issues, authentication failures, or protocol errors.

Run the following command in your terminal:

aria2c --verbose [URL]

Alternatively, you can use the short form:

aria2c -V [URL]

If you prefer to save the output to a file for later analysis instead of printing it to the screen, combine the verbose flag with the --log option. This creates a persistent record of the session.

aria2c --verbose --log=aria2.log [URL]

Using these flags ensures you capture all necessary data to resolve download issues on your Ubuntu machine.