How to Configure Aria2 Max Download Tries on Ubuntu

This guide explains how to configure the aria2 download utility on Ubuntu to limit the number of retry attempts for failed downloads. You will learn how to set this parameter using command-line arguments for one-off tasks or by editing the configuration file for persistent settings across all sessions.

Understanding the Max Tries Option

The aria2 tool uses the --max-tries option to control how many times it attempts to reconnect to a server if a connection fails. By default, this value is set to 0, which means aria2 will retry indefinitely until the download completes or is manually cancelled. Setting a specific limit prevents the utility from hanging on unreachable servers.

Setting Max Tries via Command Line

To set the maximum number of tries for a single download session, append the --max-tries flag followed by an integer to your command. For example, to limit retries to 5 attempts for a specific file, run the following command in your terminal:

aria2c --max-tries=5 http://example.com/file.zip

In this example, if the connection fails five times, aria2 will stop the download and exit with an error.

Setting Max Tries in Configuration File

For a permanent solution that applies to all downloads, you should modify the aria2 configuration file. This file is typically located at ~/.aria2/aria2.conf. If the file does not exist, you can create it.

Open the configuration file using a text editor like nano:
```
nano ~/.aria2/aria2.conf
```
Add or modify the following line to set your desired retry limit:
```
max-tries=5
```
Save the file and exit the editor.

Any subsequent aria2 commands will now adhere to this limit without needing the command-line flag. If you need to override this setting for a specific download, you can still use the --max-tries flag in the terminal, which will take precedence over the configuration file.

Verifying Your Settings

To ensure your configuration is active, you can run a test download against a non-existent URL and observe when the process terminates. Additionally, you can check the current configuration by running aria2 with the --show-console-readout option or by reviewing the log output if logging is enabled in your configuration file.

Conclusion

Configuring the maximum number of tries in aria2 on Ubuntu is a straightforward process that helps manage network resources and prevents stalled processes. Whether you choose the command-line method for flexibility or the configuration file for consistency, controlling retry limits ensures smoother download management.