Forge Home

Modules

Resources

PuppetEcosystemPuppet CommunityUpdates

linux_disable_ipv6

Disables or enables IPv6 on Linux systems
Project URLRSS FeedReport issues

6,333 downloads

709 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 1.1.0 (latest)
  • 0.1.1
  • 0.1.0
released May 1st 2022
This version is compatible with:
  • Puppet Enterprise 2023.5.x, 2023.4.x, 2023.3.x, 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x
  • Puppet >= 5.0.0

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'benformosa-linux_disable_ipv6', '1.1.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add benformosa-linux_disable_ipv6
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install benformosa-linux_disable_ipv6 --version 1.1.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

benformosa/linux_disable_ipv6 — version 1.1.0 May 1st 2022

linux_disable_ipv6

Table of Contents

  1. Description
  2. Setup - The basics of getting started with linux_disable_ipv6
  3. Usage - Configuration options and additional functionality
  4. Reference - An under-the-hood peek at what the module is doing and how
  5. Limitations - OS compatibility, etc.

Description

The linux_disable_ipv6 module disables IPv6 for Linux systems, following operating system vendor recommendations.

Setup

What linux_disable_ipv6 affects

Depending on the operating system and version, the module may affect networking, kernel configuration and bootloader configuration.

Using this module may cause issues with software which requires IPv6, such as SSH Xforwarding.

Configuration changes:

  • Creates kernel parameter configuration file /etc/sysctl.d/ipv6.conf
  • Load kernel parameters from file with sysctl -p
  • Updates initramfs with dracut -f
  • Updates flags for IPv6 transports in /etc/netconfig
  • Updates NETWORKING_IPV6 option in /etc/sysconfig/network
  • Removes IPv6 loopback address from /etc/hosts

Beginning with linux_disable_ipv6

To disable IPv6, include the class: include linux_disable_ipv6.

Usage

By default, the module will disable IPv6 for whole system.

Depending on your operating system, disabling IPv6 for specific interfaces may be supported.

Supply a list of interface names to the interfaces parameter:

class { 'linux_disable_ipv6':
  interfaces => ['lo', 'eth0'],
}

It's also possible to enable IPv6, by setting the disable_ipv6 to false:

class { 'linux_disable_ipv6':
  disable_ipv6 => false,
}

Reference

linux_disable_ipv6 class parameters

Parameter Type Default Description
disable_ipv6 Boolean true Set this to either disable or enable IPv6
interfaces Array[String] ['all'] Disable IPv6 for these interfaces. If not supported, this parameter is ignored. If it contains the value all, other interface names will be ignored.

Limitations

For a list of supported operating systems, see metadata.json.