Netgate is offering COVID-19 aid for pfSense software users, learn more.
IPv6 WAN Types¶
Similar to IPv4, the IPv6 Configuration Type controls if and how an IPv6 address is assigned to an interface. There are several different ways to configure IPv6 and the exact method depends on the network to which this firewall is connected and how the ISP has deployed IPv6.
Every ISP is different and large providers can even vary by region.
The ISP determines IPv6 settings for a circuit, and they are the only valid source for that information. As such, this documentation does not include examples for specific providers. Contact the ISP for information about their IPv6 client settings and requirements.
The ISP should provide instructions and specific values for configuring IPv6 on their service. For example, on a circuit with a static IPv6 configuration the ISP should supply the subnet addresses and prefix values for the WAN itself, as well as for routed prefixes. Providers who require DHCPv6 should supply values for settings such as the prefix delegation size, along with any requirements they have for client behavior.
For more information on IPv6, including a basic introduction, see IPv6.
When IPv6 Configuration Type is set to None, IPv6 is disabled on the interface. This is useful if the interface has no IPv6 connectivity or if the IP address on the interface is being managed in some other way, such as for an OpenVPN or GIF interface.
The Static IPv6 controls work identically to the Static IPv4 settings. See Static IPv4 for details.
With Static IPv6, the interface contains a manually configured IPv6 address. When chosen, three additional fields are available on the interface configuration screen: IPv6 Address, a prefix length selector, and the IPv6 Upstream Gateway field.
The default IPv4 and IPv6 gateways work independently of one another. The two need not be on the same circuit. Changing the default IPv4 gateway has no effect on the IPv6 gateway, and vice versa.
DHCP6 configures pfSense® software to attempt automatic IPv6 configuration of this interface via DHCPv6. DHCPv6 will configure the interface with an IP address, prefix length, DNS servers, etc. but not a gateway. The gateway is obtained via router advertisements, so this interface will be set to accept router advertisements. This is a design choice as part of the IPv6 specification, not a limitation of pfSense. For more information on router advertisements, see Router Advertisements.
Several additional fields are available for IPv6 DHCP that do not exist for IPv4 DHCP:
- Use IPv4 Connectivity as Parent Interface
When set, the IPv6 DHCP request is sent using IPv4 on this interface, rather than using native IPv6. This is only required in special cases when the ISP requires this type of configuration.
- Request only an IPv6 Prefix
When set, the DHCPv6 client does not request an address for the interface itself, it only requests a delegated prefix.
- DHCPv6 Prefix Delegation Size
If the ISP supplies a routed IPv6 network via prefix delegation, they will publish the delegation size, which can be selected here. It is typically a value somewhere between 48 and 64. For more information on how DHCPv6 prefix delegation works, see DHCP6 Prefix Delegation. To use this delegation, another internal interface must be set to an IPv6 Configuration Type of Track Interface (Track Interface) so that it can use the addresses delegated by the upstream DHCPv6 server.
- Send IPv6 Prefix Hint
When set, the DHCPv6 Prefix Delegation Size is sent along with the request to inform the upstream server how large of a delegation is desired by this firewall. If an ISP allows the choice, and the chosen size is within their allowed range, the requested size will be given instead of the default size.
When set, the DHCPv6 client is started in debug mode.
- Advanced Configuration
Enables a wide array of advanced tuning parameters for the DHCPv6 client. These options are rarely used, and when they are required, the values are dictated by the ISP or network administrator. See the dhcp6c.conf man page for details.
- Configuration Override
Enables a field to use a custom configuration file. The full path must be given. Using a custom file is rarely needed, but some ISPs require DHCP fields or options that are not supported in the pfSense WebGUI.
Stateless address autoconfiguration (SLAAC) as the IPv6 type makes pfSense attempt to configure the IPv6 address for the interface from router advertisements (RA) that advertise the prefix and related information. Note that DNS is not typically provided via RA, so pfSense will still attempt to get the DNS servers via DHCPv6 when using SLAAC. In the future, the RDNSS extensions to the RA process may allow DNS servers to be obtained from RA. For more information on router advertisements, see Router Advertisements.
6RD is an IPv6 tunneling technology employed by some ISPs to quickly enable IPv6 support for their networks, passing IPv6 traffic inside specially crafted IPv4 packets between and end user router and the ISP relay. It is related to 6to4 but is intended to be used within the ISP network, using the IPv6 addresses from the ISP for client traffic. To use 6RD, the ISP must supply three pieces of information: The 6RD prefix, the 6RD Border Relay, and the 6RD IPv4 Prefix length.
- 6RD Prefix
The 6RD IPv6 prefix assigned by the ISP, such as
- 6RD Border Relay
The IPv4 address of the ISP 6RD relay.
- 6RD IPv4 Prefix Length
Controls how much of the end user IPv4 address is encoded inside of the 6RD prefix. This is normally supplied by the ISP. A value of
0means the entire IPv4 address will be embedded inside the 6RD prefix. This value allows ISPs to effectively route more IPv6 addresses to customers by removing redundant IPv4 information if an ISP allocation is entirely within the same larger subnet.
Similar to 6RD, 6to4 is another method of tunneling IPv6 traffic inside IPv4.
Unlike 6RD, however, 6to4 uses constant prefixes and relays. As such there are
no user-adjustable settings for using the 6to4 option. The 6to4 prefix is
2002::/16. Any address inside of the
2002::/16 prefix is
considered a 6to4 address rather than a native IPv6 address. Also unlike 6RD, a
6to4 tunnel can be terminated anywhere on the Internet, not only at the end user
ISP, so the quality of the connection between the user and the 6to4 relay can
6to4 tunnels are always terminated at the IPv4 address of
IPv4 address is anycasted, meaning that although the IPv4 address is the same
everywhere, it can be routed regionally toward a node close to the user.
Another deficiency of 6to4 is that it relies upon other routers to relay traffic between the 6to4 network and the remainder of the IPv6 network. There is a possibility that some IPv6 peers may not have connectivity to the 6to4 network, and thus these would be unreachable by clients connecting to 6to4 relays, and this could also vary depending upon the 6to4 node to which the user is actually connected.
The Track Interface choice works in concert with another IPv6 interface using DHCPv6 Prefix Delegation. When a delegation is received from the ISP, this option designates which interface will be assigned the IPv6 addresses delegated by the ISP and in cases where a larger delegation is obtained, which prefix inside the delegation is used.
- IPv6 Interface
A list of all interfaces on the system currently set for dynamic IPv6 WAN types offering prefix delegation (DHCPv6, PPPoE, 6rd, etc.). Select the interface from the list which will receive the delegated subnet information from the ISP.
- IPv6 Prefix ID
If the ISP has delegated more than one prefix via DHCPv6, the IPv6 Prefix ID controls which of the delegated
/64subnets will be used on this interface. This value is specified in hexadecimal.
For example, If a
/60delegation is supplied by the ISP that means 16
/64networks are available, so prefix IDs from
fmay be used.
For more information on how prefix delegation works, see DHCP6 Prefix Delegation.