Ask Your Technical Questions to a Tailscale Solutions EngineerJuly 8 Webinar
Get started
WireGuard is a registered trademark of Jason A. Donenfeld.
© 2024 Tailscale Inc. All rights reserved. Tailscale is a registered trademark of Tailscale Inc.
Go back

Choose your own IP

December 07 2023
Maisem Ali
Maisem Ali

Tailscale assigns every one of your nodes a private IPv4 address. We do this from the CGNAT range, which is typically used by ISPs that have run out of public IPv4 addresses. Starting today, you have control over what IP address from that range is assigned to your nodes. This gives you the ability to decide what subset of the CGNAT range your tailnet uses to avoid conflicts with other applications.

Globally unique to locally unique

In the early days of Tailscale we decided to allocate every node a unique IP address within the Tailscale universe. This was particularly handy for node sharing, when you let someone from another tailnet access a node in your tailnet, they got to see it as the same CGNAT address. It also met our needs when we were an early-stage startup; the CGNAT range has some four million IP addresses, plenty for an experimental project that may or may not be interesting to users. It turns out people like to use Tailscale and we are running out of IPs.

We had a few options — we could add other private IP address ranges to the CGNAT space we allocate, but this would have at best been a stopgap. Or, we could have required all users to use IPv6 addresses, as we already also allocate nodes and addresses from the much larger pool of IPv6 ULA addresses. We all know how well IPv6 adoption has gone — this would have broken legacy software our customers use that does not support IPv6. Rather, we decided to no longer allocate globally unique CGNAT addresses, and allow the reuse of CGNAT addresses in different tailnets.

It also gives us the flexibility to allow enterprises to limit the range of CGNAT IP addresses that get allocated to their tailnets, for compatibility with other systems that allocate from parts of the CGNAT range.

Jump into your own pool

Along with flexible addressing, we are launching a beta feature to let you define the IP pool that your nodes are assigned from the CGNAT range. This is done as part of your tailnet policy:

        "acls": ["..."],
        "nodeAttrs": [
                "target": ["autogroup:admin"],
                "ipPool": [""],
                "target": ["group:dev"],
                "ipPool": [""],

With this node attribute set, all new nodes managed by admins in your tailnet will be assigned an IP from the range:, whereas nodes managed by members of group:dev will be assigned an IP from a subset from the range:

Change IP of existing nodes

Before these changes, IPv4 addresses were immutable. With locally unique IPv4, however, you can change the address for any node in your tailnet in a couple clicks, even nodes that have been shared to you!

NATural solutions

Address reuse causes no issue in the common case of a perfectly private tailnet, but if not implemented carefully, it could wreak havoc with node sharing. If I try to share my node with you, and you already have a node numbered, where do your packets go?

To address this (no pun intended), we assign shared nodes a new IP address from the tailnet it is shared into. Each Tailscale node collects a new IP address for each share. Assigning multiple addresses to an interface causes a lot of UX pain with some software, so instead nodes in the shared-to tailnet 1-1 NAT packets destined for the shared node, right before they flow into the WireGuard tunnel.

This means the tailnet of the shared node never has to be aware of the IP addresses assigned to it in other tailnets, which greatly simplifies accounting.

Now, each tailnet can have up to four million nodes with IPv4 addresses. If you are the sort of enterprise that needs more than that, let’s chat.

One thing you can rely on with IPv4: whatever the problem, Network Address Translation is part of the solution.

Subscribe to Tailscale’s blog

We have a deep commitment to keeping your data safe.

Too much email?RSSX

Try Tailscale for free

Schedule a demo
Contact sales
cta phone
Hugging Face