How to Disable IPv6 in aria2?

This article provides a direct answer and practical guide on whether you can disable IPv6 support entirely when running an aria2 command. You will learn the specific command-line options and configuration settings required to force aria2 to use IPv4 exclusively, preventing potential connectivity issues or slow download speeds associated with IPv6 misconfigurations.

Disabling IPv6 in aria2

Yes, you can completely disable IPv6 support when running an aria2 command. The utility provides a dedicated command-line flag specifically designed to restrict network traffic to IPv4.

To force aria2 to ignore IPv6 and only use IPv4 for a specific download, you need to use the --disable-ipv6 option.

The Command-Line Syntax

You can append this flag directly to your download command. Here is the standard syntax:

aria2c --disable-ipv6=true "your_download_link_here"

In many versions of aria2, simply passing the flag without the explicit =true assignment also works, as the presence of the flag defaults to enabling the restriction:

aria2c --disable-ipv6 "your_download_link_here"

Making the Change Permanent

If you find that you always need to disable IPv6 due to network environment constraints, you can add this setting to your global aria2 configuration file (typically named aria2.conf).

Open your aria2.conf file in a text editor and add the following line:

disable-ipv6=true

Once saved, aria2 will automatically apply this setting to every command you run, eliminating the need to type the flag manually each time.