Knowledge base — mesh-net

Basics

What mesh-net is, the free public network and rooms, and what to do when something doesn't work.

Getting startedWhat mesh-net is, how the public network differs from private ones, and the first three steps in the dashboard.
The public networkA free shared mesh network: connect your devices from any OS and see who reaches whom.
RoomsConnect chosen devices of several accounts in the public network: create a room, invite people, pick devices.
Troubleshooting and FAQWhat to check when a device is offline, a subnet doesn't answer or a record doesn't update, and how to reach support.

Free names in our zones, DNS records, dynamic DNS and moving the DNS of your own domain.

Names and DNS recordsClaim a free name in our zones, give it A, AAAA, CNAME, MX, TXT, SRV or CAA records, or just reserve it.
Dynamic DNSKeep a name pointed at a changing IP: from a mesh node with no software, or from a router or ddclient over dyndns2.
Your own domainMove the DNS of a domain you already own to mesh-net: prove ownership, check the records, switch the name servers.

Private mesh networks: devices, subnet routers, exit nodes and publishing services.

Private networksYour own mesh network with its own control server: create it, add devices, manage users, keys and tags.
Subnet routers and exit nodesReach whole LANs through one device, keep routes highly available, send traffic out through an exit node.
Publishing servicesPut a service from your network on the internet: HTTP/S on a subdomain with our TLS, or TCP/UDP on a public port.
Move your headscale network to mesh-netStep by step, no command-line experience needed: pack your own headscale network with one line, download the file, upload it and move the devices — they keep their addresses.
Run your network on your own serverStep by step, without knowing commands: move a private network from mesh-net to a server you rent — the devices keep their addresses.

Permissions inside private networks: rules, groups, presets and HuJSON.

Access rulesDecide who in a private network reaches whom and on which ports — with simple rules or your own HuJSON.

Overlapping subnets, changing a mesh address, moving a network and backups.

Overlapping subnetsReach LANs that use the same addresses behind different gateways: sites and 4via6.
Changing a device's mesh addressGive a device of a private network a different 100.x address: what happens and what to watch out for.
Export, import, backup and restoreMove a network to your own headscale and back, keep backups, bring a network back to an earlier state.

Sign-in and two-factor authentication, notifications, plans and payments.

NotificationsThe feed and the emails: which network events reach you, and how to track a device going online or offline.
Account and securitySign-in codes, your password, two-factor authentication with backup codes, and automatic sign-out.
Plans and billingWhat Free, Paid and Beta include, add-ons, paying and renewing, and what happens when something ends.