Partner – Moderne – NPI EA (cat=Spring Boot)
announcement - icon

Refactor Java code safely — and automatically — with OpenRewrite.

Refactoring big codebases by hand is slow, risky, and easy to put off. That’s where OpenRewrite comes in. The open-source framework for large-scale, automated code transformations helps teams modernize safely and consistently.

Each month, the creators and maintainers of OpenRewrite at Moderne run live, hands-on training sessions — one for newcomers and one for experienced users. You’ll see how recipes work, how to apply them across projects, and how to modernize code with confidence.

Join the next session, bring your questions, and learn how to automate the kind of work that usually eats your sprint time.

Course – Black Friday 2026 – NPI EA – main – before_post_content
announcement - icon

Yes, we're now running our Black Friday Sale. All Courses are 33% off until 1st December, 2026 at 17:00 Romania time:

>> EXPLORE ACCESS NOW

Course – Black Friday 2026 – NPI – main – before_post_content
announcement - icon

Yes, we're now running our Black Friday Sale. All Courses are 33% off until 1st December, 2026 at 17:00 Romania time:

>> EXPLORE ACCESS NOW

1. Overview

Java networking operates on top of the underlying operating system’s stack, and the JVM often selects IPv6 addresses when both IPv4 and IPv6 are available. This pattern of operation can cause unforeseen problems such as lost connections, timeouts, or misrouted data, particularly when systems don’t correctly configure or enable IPv6.

In this tutorial, we’ll examine how to disable IPv6 in Java using a JVM system property and, if necessary, at the operating system level.

2. Using a System Property

Java has a built-in capability to control whether the JVM prefers IPv4 or IPv6 using system settings.

The most popular solution is to set the java.net.preferIPv4Stack attribute to true. This tells the JVM only to use the IPv4 stack for networking activities:

java -Djava.net.preferIPv4Stack=true -jar myapp.jar

When the program sets this parameter, any Socket, ServerSocket, or DatagramSocket connects only to IPv4 addresses. This effectively disables IPv6 in the JVM without requiring any changes to the operating system.

This attribute should be set programmatically before initiating any network connections:

public class DisableIPv6Example {
    public static void main(String[] args) {
        System.setProperty("java.net.preferIPv4Stack", "true");
        System.out.println("IPv6 disabled. Using IPv4 stack.");
    }
}

In this example, we set the property before loading any networking classes. If a socket or DNS resolution starts first, the JVM may already have chosen the networking stack, and the change will not take effect.

Another relevant property is java.net.preferIPv6Addresses. By default, it’s false, indicating that the JVM favours IPv4 when both are available. Setting it to true reverses the behaviour and makes IPv6 the default. Furthermore, using java.net.preferIPv4Stack=true overrides this option.

3. Disabling IPv6 at the OS Level

In some cases, simply setting the JVM property may not be sufficient. If the operating system supports IPv6, specific libraries or native code may continue to try to use IPv6 sockets. In such instances, disabling IPv6 at the OS level ensures that all applications, including Java, use IPv4.

3.1. Linux

On Linux, IPv6 is typically enabled by default. If we want Java and all other apps to depend solely on IPv4, we can turn off IPv6 at the kernel level:

$ sudo sysctl -w net.ipv6.conf.all.disable_ipv6=1
$ sudo sysctl -w net.ipv6.conf.default.disable_ipv6=1

In this example, these commands immediately disable IPv6 on all network interfaces, but the change does not persist after a reboot. To make the configuration permanent, we can include the same lines in the /etc/sysctl.conf file and reload using sudo sysctl -p.

Another approach is to deactivate IPv6 at boot time by entering the kernel parameter ipv6.disable=1 into the GRUB configuration in /etc/default/grub, then update GRUB and reboot the system. This method ensures that IPv6 is deactivated system-wide from the start.

In conclusion, sysctl is a quick approach to disable IPv6; however, altering /etc/sysctl.conf or the kernel boot parameters is a more permanent solution that ensures Java and all other apps rely solely on IPv4.

3.2. Windows

On Windows, IPv6 can be disabled in the network adapter settings. To do this, we open the Control Panel, navigate to Network and Sharing Centre, and then select Change adapter settings. Next, right-click the active network adapter, select Properties, and uncheck the option labelled Internet Protocol Version 6 (TCP/IPv6). This disables IPv6 for that specific adapter, enabling applications such as Java to utilise IPv4.

IPv6 can also be disabled at the system level via the Windows Registry. We can set the DisabledComponents value under the key HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\Tcpip6\Parameters. Assigning the required value disables IPv6 on all interfaces. Microsoft provides specific advice on which parameters to use depending on whether we want to disable IPv6 altogether or partially.

Finally, on Windows, we can disable IPv6 per adapter through the graphical interface or system-wide via the registry. Both approaches ensure that any Java programs running on the system use only IPv4.

3.3. macOS

On macOS, the networksetup command can be used to disable IPv6. First, we use the networksetup -listallnetworkservices command to determine the name of the network service. Once we have the service name, such as “Wi-Fi”, we can turn off IPv6 for that interface:

$ networksetup -setv6off "Wi-Fi"

In this example, we turn off IPv6 on the chosen interface. Thereby forcing the system to utilise IPv4. If we wish to re-enable IPv6, we can use networksetup -setv6automatic “Wi-Fi”.

In conclusion, macOS provides a simple solution to disable IPv6 at the interface level with networksetup. When implemented, this ensures that programs such as Java no longer attempt to use IPv6, but instead rely solely on IPv4.

4. Conclusion

In this article, we discussed various ways to disable IPv6 in Java. The most straightforward approach is to set the java.net.preferIPv4Stack property, either from the command line or manually, which compels the JVM to utilise IPv4 for all networking activities. We also investigated situations in which this may not be sufficient and discovered that disabling IPv6 at the operating system level provides a more permanent solution across Linux, Windows, and macOS.

In most cases, changing the system property resolves connectivity issues in Java applications. However, if the environment or external libraries continue to use IPv6, modifying the operating system setup ensures that the JVM and all other programs always utilise IPv4.

Partner – Moderne – NPI EA (tag=Refactoring)
announcement - icon

Modern Java teams move fast — but codebases don’t always keep up. Frameworks change, dependencies drift, and tech debt builds until it starts to drag on delivery. OpenRewrite was built to fix that: an open-source refactoring engine that automates repetitive code changes while keeping developer intent intact.

The monthly training series, led by the creators and maintainers of OpenRewrite at Moderne, walks through real-world migrations and modernization patterns. Whether you’re new to recipes or ready to write your own, you’ll learn practical ways to refactor safely and at scale.

If you’ve ever wished refactoring felt as natural — and as fast — as writing code, this is a good place to start.

Course – Black Friday 2026 – NPI EA – main – after_post_content

announcement - icon

Yes, we're now running our Black Friday Sale. All Courses are 33% off until 1st December, 2026 at 17:00 Romania time:

>> EXPLORE ACCESS NOW

Course – Black Friday 2026 – NPI – main – after_post_content

announcement - icon

Yes, we're now running our Black Friday Sale. All Courses are 33% off until 1st December, 2026 at 17:00 Romania time:

>> EXPLORE ACCESS NOW