Bring your own router.
The settings your router needs, in order, with examples for OpenWrt, OPNsense, Linux with pppd and VyOS.
You can also choose the Tuckamore router, preconfigured. See the router
What your router needs
| Field | Value |
|---|---|
| WAN port, 3 Gbps service | 5 Gbps Ethernet or faster |
| WAN port, 8 Gbps service | 10 Gbps Ethernet |
With 1.5 Gbps service, your router needs an SFP port.
Two ways to run 464XLAT
| Compared | Devices translate | Router translates |
|---|---|---|
| Router settings | PREF64 and DHCPv4 option 108 | CLAT and a private IPv4 DHCP pool |
| Numeric IPv4 addresses | The devices listed below | Every device, legacy Windows software included |
| Home network | IPv6 | IPv6 and private IPv4 |
| Examples | OpenWrt, OPNsense, Linux with pppd, VyOS | OpenWrt, OPNsense, Linux with pppd |
Both can run together.
Devices with their own CLAT
| Field | Value |
|---|---|
| Android phones and tablets | |
| Version | Android 12 and later, on Wi-Fi and Ethernet |
| Turns on with | Option 108 |
| NAT64 prefix from | PREF64 or DNS64 |
| iPhone and iPad | |
| Version | iOS 17 and iPadOS 17 and later |
| Turns on with | Option 108 |
| Mac | |
| Version | macOS Monterey 12.0.1 and later |
| Turns on with | Option 108 |
| NAT64 prefix from | PREF64 |
| Windows PC | |
| Version | Windows 11 Insider Preview, Canary Channel, build 29599 and later |
| Turns on with | Option 108, after the netsh command and a restart |
| NAT64 prefix from | PREF64 or DNS64 |
| Linux desktop | |
| Version | NetworkManager 1.58 and later |
| Turns on with | ipv4.clat set to auto on the connection, and a reconnect |
| NAT64 prefix from | PREF64 |
Set it up, step by step
| Field | Value |
|---|---|
| Your router to the ONT | Ethernet, WAN port to ONT The ONT, in your router's SFP port |
| Field | Value |
|---|---|
| New interface on your WAN port | Tagged VLAN 40 |
| Field | Value |
|---|---|
| PPPoE on the VLAN 40 interface | On |
| Username and password | From your Tuckamore accountSign in |
| Field | Value |
|---|---|
| WAN port | 1528 |
| VLAN 40 device | 1528 |
| PPPoE session | 1520 |
| Router with a lower maximum | Its maximum |
| Field | Value |
|---|---|
| IPv6 on the PPPoE session | On |
| IPCP | Off |
| IPCP, static IPv4 add-on | On |
| Router address | SLAAC |
| DHCPv6-PD request | /56 |
| Field | Value |
|---|---|
| LAN | A /64 from the delegated /56 |
| Field | Value |
|---|---|
| DNS servers | 2001:4860:4860::6464 and 2001:4860:4860::64 |
| Field | Value |
|---|---|
| Devices translate | |
| PREF64 | 64:ff9b::/96 |
| DHCPv4 option 108 | 1800 |
| Router translates | |
| CLAT | On |
| CLAT IPv4 MTU | 1500 |
| Field | Value |
|---|---|
| Command, in an administrator terminal | netsh interface clat set global permit=enabled pref64fromra=enabled pref64fromdns=enabled |
| Then | Restart |
Examples
Replace the port names and account details with your own.
OpenWrt
| Field | Value |
|---|---|
| Version | OpenWrt 25.12.1 and later |
Before you paste
| Field | Value |
|---|---|
The first section's name and the second section's ifname | Your WAN port, for example wan or eth1 |
Existing config device section for your WAN port | Add option mtu '1528' to it, and skip the first section |
YOUR_USERNAME and YOUR_PASSWORD | From your Tuckamore account |
Existing lan section | Set ip6assign '64' there |
- Add to
/etc/config/network
config device
option name 'wan'
option mtu '1528'
config device
option type '8021q'
option ifname 'wan'
option vid '40'
option name 'wan.40'
option mtu '1528'
config interface 'wan'
option device 'wan.40'
option proto 'pppoe'
option username 'YOUR_USERNAME'
option password 'YOUR_PASSWORD'
option ipv6 '1'
option pppd_options 'noip'
option peerdns '0'
option mtu '1520'
config interface 'wan6'
option device '@wan'
option proto 'dhcpv6'
option reqaddress 'try'
option reqprefix '56'
option peerdns '0'
list dns '2001:4860:4860::6464'
list dns '2001:4860:4860::64'
config interface 'lan'
option ip6assign '64'Optional: 464XLAT
- Devices translate
- Run these commands
uci set dhcp.lan.ra_pref64='64:ff9b::/96'
uci add_list dhcp.lan.dhcp_option='108,1800'
uci commit dhcp| Field | Value |
|---|---|
| Package | 464xlat |
wan6 section | Add option iface_464xlat '0' |
wan firewall zone in /etc/config/firewall | Add xlat |
wan firewall zone's mtu_fix | '1' |
/etc/sysupgrade.conf | Add /etc/hotplug.d/iface/10-xlat-mtu |
- Add to
/etc/config/network
config interface 'xlat'
option proto '464xlat'
option tunlink 'wan6'
config device
option name '464-xlat'
option mtu '1500'- Save as
/etc/hotplug.d/iface/10-xlat-mtu
[ "$INTERFACE" = xlat ] || exit 0
case "$ACTION" in
ifup|ifupdate)
ip -6 route replace "$(cat /tmp/464-xlat-anycast)/128" dev 464-xlat table prelocal proto static mtu lock 1520
;;
esacFinish up
| Field | Value |
|---|---|
| Your settings | Save, then reboot the router |
| Static IPv4 add-on | uci delete network.wan.pppd_options && uci commit network && ifup wan |
| Command | Expected output |
|---|---|
ip link show pppoe-wan | mtu 1520 |
ip link show wan.40 | mtu 1528 |
ip link show with your WAN port's name | mtu 1528 |
| Router translates | |
ip link show 464-xlat | mtu 1500 |
ip -6 route show table prelocal | dev 464-xlat with mtu lock 1520 |
OPNsense
Router translates needs a plugin on OPNsense. OPNsense 26.7 has no CLAT of its own, so we built os-clat, a plugin that adds one. Install it in three steps under Router translates. Devices translate needs no plugin.
| Field | Value |
|---|---|
| Version | OPNsense 26.7.6 and later |
| Field | Value |
|---|---|
| Page | Interfaces[WAN] |
| IPv4 Configuration Type | None |
| IPv6 Configuration Type | None |
| Finish with | Save, then Apply changes |
![OPNsense Interfaces: [WAN] page, with IPv4 Configuration Type and IPv6 Configuration Type both set to None.](/router-setup/opnsense-01-wan-none.png)
| Field | Value |
|---|---|
| Page | InterfacesDevicesVLAN, a new device |
| Device | vlan0.40 |
| Parent | The port cabled to the ONT |
| VLAN tag | 40 |
| Finish with | Save, then Apply |

| Field | Value |
|---|---|
| Page | InterfacesDevicesPoint-to-Point, a new device |
| Link Type | PPPoE |
| Link interface(s) | vlan0.40 |
| Username and Password | From your Tuckamore account |
| Service name and Host-Uniq | Empty |
| Finish with | Save |

| Field | Value |
|---|---|
| Page | InterfacesAssignments |
pppoe0 in the Device list | Up to a minute after step 3 |
| The WAN row, with its pencil button | |
| Device | pppoe0 (vlan0.40), followed by your username |
| IPv4 Configuration Type and IPv6 Configuration Type | None |
| Finish with | Save |
| A new row, with the + button | |
| Device | The port cabled to the ONT |
| Description | UPLINK |
| Finish with | Save, then Apply |

| Field | Value |
|---|---|
| Page | Interfaces[UPLINK] |
| Enable | Ticked |
| Lock | As it is |
| IPv4 Configuration Type | None |
| IPv6 Configuration Type | None |
| MTU | 1508 |
| Finish with | Save, then Apply changes |
![OPNsense Interfaces: [UPLINK] page, with Enable ticked, both Configuration Types set to None and MTU 1508.](/router-setup/opnsense-05-uplink.png)
| Field | Value |
|---|---|
| Page | Interfaces[WAN] |
| Enable | Ticked |
| IPv4 Configuration Type | None |
| IPv4 Configuration Type, static IPv4 add-on | PPPoE |
| IPv6 Configuration Type | DHCPv6 |
| MTU | 1508 |
| PPPoE session, with this MTU | 1500 |
| MTU under the Point-to-Point device's Link Parameters | Empty |
| DHCPv6 client configurationPrefix delegation size | 56 |
| DHCPv6 client configurationRequest prefix only | Ticked |
| DHCPv6 client configurationSend prefix hint | Ticked |
| Finish with | Save, then Apply changes |
| If the page does not load after Apply changes | Load it again. Your changes are applied. |
![OPNsense Interfaces: [WAN] page, with Enable ticked, IPv4 Configuration Type None, IPv6 Configuration Type DHCPv6 and MTU 1508.](/router-setup/opnsense-06-wan.png)
| Field | Value |
|---|---|
| Page | Interfaces[LAN] |
| IPv6 Configuration Type | Identity association |
| Parent interface | WAN |
| Assign prefix ID | 0 |
| With Identity association | |
| ServicesDnsmasq DNS & DHCPGeneralRouter advertisements | Ticked |
| ServicesDnsmasq DNS & DHCPDHCP ranges | A LAN entry with Constructor LAN and RA mode slaac. The arrow before LAN opens its entries. |
| With Track Interface (legacy) | |
| Parent interface and Assign prefix ID | The same values |
| Dnsmasq settings | As they are |
![OPNsense Interfaces: [LAN] page, with IPv6 Configuration Type Identity association, Parent interface WAN and Assign prefix ID 0.](/router-setup/opnsense-07-lan.png)
| Field | Value |
|---|---|
| Page | SystemSettingsGeneral |
| DNS servers | 2001:4860:4860::6464 and 2001:4860:4860::64 |
| Allow DNS server list to be overridden by DHCP/PPP on WAN | Cleared |
| Finish with | Save |

| Field | Value |
|---|---|
| Page | ServicesUnbound DNSQuery Forwarding |
| Use System Nameservers | Ticked, then Apply |
| The following nameservers are used | The two DNS servers of step 8 |
| Page | ServicesUnbound DNSGeneral |
| Enable DNS64 Support and Enable DNSSEC Support | Cleared |

| Where to look | Expected |
|---|---|
| InterfacesOverview, the magnifier button (Details) on the WAN row | mtu 1500 |
| The same button on the UPLINK row | mtu 1508 |

| Field | Value |
|---|---|
| MTU on UPLINK | Cleared |
| MTU on the WAN | Cleared |
| Finish with, on both pages | Save, then Apply changes |
| PPPoE session, with both cleared | 1492 |
| Details on the WAN row | mtu 1492 |
Optional: 464XLAT
OPNsense runs Devices translate and Router translates.
Devices translate
| Field | Value |
|---|---|
| Page | ServicesDnsmasq DNS & DHCPGeneral |
| Router advertisements | Cleared, then Apply |
| Page | ServicesDnsmasq DNS & DHCPDHCP ranges, the LAN entry with Constructor LAN |
| RA mode | Clear All, so it reads Default |
| Finish with | Save, then Apply |
| Until RA mode reads Default | Dnsmasq keeps sending router advertisements |
| With Track Interface (legacy) | Straight on to step 2 |

| Field | Value |
|---|---|
| Page | ServicesRouter Advertisements, a new entry |
| Enabled | Ticked |
| Interface | LAN |
| Mode | Unmanaged |
| advanced mode, the switch at the top left | On |
| NAT64 prefix | 64:ff9b::/96 |
| Finish with | Save, then Apply |

| Field | Value |
|---|---|
| Page | ServicesDnsmasq DNS & DHCPDHCP options, a new option |
| Type | Set |
| Option | ipv6-only [108] |
| Interface | LAN |
| Value | 1800 |
| Force | Cleared |
| Finish with | Save, then Apply |
![OPNsense Edit DHCP option window, with Type Set, Option ipv6-only [108], Interface LAN and Value 1800.](/router-setup/opnsense-dt-3-option108.png)
Router translates
| Field | Value |
|---|---|
| Plugin | os-clat |
| Before you start | Steps 1 to 9 |
| CLAT IPv4 MTU, with WAN MTU 1508 | 1480 |
| TCP MSS, with WAN MTU 1508 | 1440 |
| CLAT IPv4 MTU, with UPLINK at 1500 | 1472 |
| TCP MSS, with UPLINK at 1500 | 1432 |
| Field | Value |
|---|---|
| Page | SystemFirmwareStatus |
| Finish with | Check for updates, then Update |
| Field | Value |
|---|---|
| A root shell on the console | |
| Sign in as | root |
| Menu option | 8) Shell |
| A root shell over SSH, once Secure Shell is on | |
| Page | SystemSettingsAdministration, under Secure Shell |
| Enable Secure Shell | Ticked |
| Permit root user login | Ticked |
| Permit password login | Ticked |
| Finish with | Save |
| Sign in as | root, then menu option 8) Shell |
| After the command | The three boxes as they were, then Save |
- Run in the root shell
- This one line
mkdir -p /usr/local/etc/pkg/fingerprints/os-clat/trusted /usr/local/etc/pkg/fingerprints/os-clat/revoked && fetch -o /usr/local/etc/pkg/fingerprints/os-clat/trusted/os-clat.fingerprint https://os-pkg.gettuckamore.ca/os-clat.fingerprint && fetch -o /usr/local/etc/pkg/repos/os-clat.conf https://os-pkg.gettuckamore.ca/os-clat.conf| Where to look | Expected |
|---|---|
| SystemFirmwareStatusRepositories | OPNsense and os-clat |

| Field | Value |
|---|---|
| Page | SystemFirmwarePlugins |
| End of the list | Click to view the community plugins. |
os-clat | Its + button (Install) |
| Third party software notice | Install |
| The Updates tab, last line | ***DONE*** |
| ServicesCLAT in the menu | After you load the page again |

| Where to look | Expected |
|---|---|
| ServicesCLATSettingsState | Active. |
| NAT64 prefix | 64:ff9b::/96 (DNS) |
| MTU and MSS | IPv4 1480, TCP MSS 1440 |
| MTU and MSS, with UPLINK at 1500 | IPv4 1472, TCP MSS 1432 |
| Checks | No findings. |
| The settings on the same page | As installed |
| While State reads Listening: no NAT64 prefix found. | |
| State turns to Active. | Up to five minutes after names resolve on the router again. Longer after a long DNS outage. |
| To skip the wait | Apply on the same page |

| Field | Value |
|---|---|
| New os-clat versions | Arrive with your OPNsense updates, through Check for updates, then Update |
| IPv4 during an os-clat update | Pauses for a few seconds |
| Field | Value |
|---|---|
| Check for updates | Reports an error and lists no updates, those of OPNsense included |
| After the command under this table | OPNsense updates are listed again |
| The plugin | Stays installed and Active, listed as os-clat (orphaned) |
| os-clat updates | Back after you add the os-clat repository again |
- Run in the root shell
- To bring OPNsense updates back
rm -f /usr/local/etc/pkg/repos/os-clat.conf| Field | Value |
|---|---|
| Page | SystemFirmwarePlugins |
| os-clat (installed) | Its bin button (Remove) |
| Confirm removal window | OK |
- Run in the root shell
- To remove the repository as well
rm -f /usr/local/etc/pkg/repos/os-clat.conf && rm -rf /usr/local/etc/pkg/fingerprints/os-clatOther routers
| Field | Value |
|---|---|
| pppd version | 2.5.3 and later |
| Your PPPoE peer's options file | +ipv6 and noip |
| Static IPv4 add-on | Remove noip, then reconnect |
| WAN port MTU | 1528 |
| VLAN 40 device MTU | 1528 |
- Commands for
- The WAN port and its VLAN 40 device
eth0- Your WAN port
ip link set dev eth0 mtu 1528
ip link add link eth0 name eth0.40 type vlan id 40
ip link set dev eth0.40 mtu 1528
ip link set dev eth0 up
ip link set dev eth0.40 upAdd the same values to your system's network configuration.
- Add to
- Your peer's options file, replacing any
plugin, interface,mtuandmrulines
plugin pppoe.so
nic-eth0.40
mtu 1520
mru 1520| Command | Expected output |
|---|---|
ip link show ppp0 | mtu 1520 |
sysctl net.ipv6.conf.ppp0.mtu | 1520 |
| Field | Value |
|---|---|
| IPv6 | set interfaces pppoe pppoe0 ipv6 address autoconf |
| Static IPv4 add-on | disconnect interface pppoe0, then connect interface pppoe0 |
| PPPoE session MTU | 1500 |
| WAN port and VLAN 40 device MTU | 1508 |
| 464XLAT | Devices translate |
- Commands for
- MTU and the PPPoE source interface
eth0- Your WAN port
set interfaces ethernet eth0 mtu 1508
set interfaces ethernet eth0 vif 40 mtu 1508
set interfaces pppoe pppoe0 source-interface eth0.40
set interfaces pppoe pppoe0 mtu 1500| Command | Expected output |
|---|---|
ip link show pppoe0, after commit and save | mtu 1500 |
Optional: 464XLAT on Linux with pppd
| Field | Value |
|---|---|
| radvd version | 2.20 and later |
| Option 108, dnsmasq 2.87 and later | dhcp-option=option:ipv6-only,1800 |
Option 108, Kea, in your LAN's subnet4option-data | { "name": "v6-only-preferred", "data": "1800" } |
- Add to
/etc/radvd.conf, inside your LAN interface's section
nat64prefix 64:ff9b::/96 {
AdvValidLifetime 1800;
};| Field | Value |
|---|---|
| CLAT | Jool |
| Packages | jool-dkms and jool-tools |
| LAN | 192.168.1.1/24 |
| dnsmasq pool | dhcp-range=192.168.1.100,192.168.1.249,12h |
- Commands for
- The Jool CLAT
YOUR_PREFIX- The first four groups of your LAN's /64
sysctl -w net.ipv4.conf.all.forwarding=1
sysctl -w net.ipv6.conf.all.forwarding=1
modprobe jool_siit
jool_siit instance add --netfilter --pool6 64:ff9b::/96
jool_siit global update lowest-ipv6-mtu 1520
jool_siit eamt add 192.168.1.0/24 YOUR_PREFIX::c0a8:100/120Optional: 464XLAT on VyOS
eth1- Your LAN interface
LAN- Its DHCP shared network
- Finish with
- Commit and save
set service router-advert interface eth1 nat64prefix 64:ff9b::/96
set service dhcp-server shared-network-name LAN option ipv6-only-preferred 1800A working connection shows
| Where to look | Expected |
|---|---|
| PPPoE session | IPv6CP up |
| Your router's connection | A /64, by SLAAC |
| Your home network | A /56, by DHCPv6-PD |
| IPv4-only sites | Open in your browser |
| Legacy Windows software, with 464XLAT | Reaches IPv4 sites |