Get started
© 2024

Domain ownership

When you create your Tailscale network, also known as a tailnet, your user domain becomes part of your Tailscale identity.

The guidance in this topic also applies for Tailscale accounts based on GitHub organizations, GitHub personal accounts, and for single-user tailnets based on email/user identity.

Ensure that you maintain control of your domain, to prevent malicious takeover of your tailnet.

How your domain is used

Tailscale requires you to show ownership and control of a user's domain when signing up with a custom OIDC identity provider, or when requesting help from our support team for certain issues. Depending on your request, we will ask you to do one of the following actions:

  • Set DNS TXT records.
  • Respond to a confirmation email sent to a * email address. For example, an email sent from Tailscale support to the owner admin of a tailnet when another user of the tailnet is requesting some action on the tailnet.
  • Set up a WebFinger endpoint.

For verification of GitHub organization, the owner of the tailnet must also be an admin of the GitHub organization.

Once your tailnet is created, your domain is always associated with the tailnet, and you need to maintain control over and use of your domain for the lifetime of your tailnet.

Mitigating tailnet risk from a malicious takeover

To help mitigate the impact of a malicious actor gaining control of your domain, there are several settings you can use with your tailnet:

  • Enable device approval so that an admin can review and approve new devices before they can join the tailnet.
  • Enable user approval so that an admin can review and approve new users before they can join the tailnet.
  • Use tailnet lock to verify that no device is added to your tailnet without being signed by a trusted device already in your tailnet.

For general guidance on securing your tailnet, see Best practices to secure your tailnet.

If you no longer use your domain

If you need to change domain names or relinquish an old name and move to a new name, contact support so we can rename the tailnet for you.

If you delete your domain, your tailnet is not automatically deleted. If you want to delete your tailnet, you need to explicitly delete your tailnet.