Names and DNS records

Claim a name

A name is your piece of one of our zones (mesh-net.space, mesh-net.online, mesh-net.site), for example myhome.mesh-net.space. You point it wherever you need with DNS records, or keep it reserved for later.

1. Open Domains in the menu.
2. Press Add name at the top right: a form opens under the header. Type the name (myhome), pick the zone after the dot, then the record type.
3. Enter the value: the field shows a hint for the chosen type (see Record types). You may leave it empty — see Reserve a name.
4. Press Add. A record with a value is published in DNS at once; you land on the name's page.

Each name appears in the list with its records; a click on the name opens its page: there you add more records, edit or delete them and set up dynamic DNS.

Which names you can take

• Latin letters, digits, hyphens, underscores and dots: myhome, nas.myhome, _dmarc.myhome. Capital letters become lowercase.
• A branch has one owner. A name with dots belongs to the branch of its last part: nas.myhome, www.myhome and _acme-challenge.myhome are all in the branch myhome. Once myhome (or any name under it) is yours, nobody else can add names to that branch — and you can't add names to a branch that belongs to someone else.
• Names that start with “_” right under the zone belong to mesh-net. Put such records under your own name: _dmarc.myhome, not _dmarc.
• These first-level names are reserved: admin, api, app, chat, ftp, hs, mail, ns, ns1, ns2, panel, smtp, www.
• The root of a zone (@, the zone itself) is not available.
• A name that already serves as the address of a private network is taken.

Record types

• One record of each type per name. A second A record for the same name isn't added — edit the existing one instead. Two TXT values for one name are not possible either; on your own domain they are.
• A CNAME must be the only record of its name: don't combine it with A, MX or TXT on the same name.
• Records of names in our zones have a TTL of 300 seconds.

Examples

Reserve a name without records

Leave the value empty when you add a name:

• an A or AAAA record then waits for an address from dynamic DNS — a mesh device or your router fills it in;
• with any other type, the name is simply reserved: it is yours, but nothing is published in DNS. The list shows it as reserved (no address).

A reserved name is what a private network needs for its address: a free name with no DNS records. Clearing the value of a record later returns the name to the reserved state as well.

Edit and delete records

1. Open the name: click it in the list on Domains. The table DNS records lists its records with their status: published (in DNS), pending (saved, not in DNS yet) or reserved.
2. The pencil in a record's row (Edit) opens a small form right under it: change the type or the value and press Save. An empty value reserves the name again and removes the record from DNS.
3. The bin (Delete) removes the record after a confirmation. When the last record of a name is deleted, the name is free again and leaves your list.
4. Add record at the top of the name's page adds a record of another type to the same name.

A name that is the address of one of your private networks is shown read-only: its record is kept by mesh-net and leads the network's devices to their server. To free the name, delete the network.

The same goes for a name you publish a service on over HTTP/S: while the route exists, mesh-net keeps the name's record, which leads visitors to the network's server. To free the name, delete the route; the record keeps pointing at that server until you change it.

Limits

• The plan sets how many names (the dashboard calls them domains) an account holds: 3 on Free, 10 on Paid. The counter at the top right of Domains shows the use, like Domains 1/3; Get more next to it offers the add-on below.
• A name counts once however many record types it has. myhome and nas.myhome are two names. Your own domain counts as one name.
• The add-on +5 domains raises the limit by 5 for a year for 149 ₽. Packs stack with the plan and with each other: one more pack adds 5 more names and moves the packs' shared end date by a year. You buy it on the same page.
• What happens to names over the limit when a plan or a pack ends: Plans and billing.

How fast changes appear

Our name servers publish a record the moment you save it. Resolvers that asked for the name before may keep the old answer until its TTL (300 seconds) runs out. To check what DNS says right now:

dig +short myhome.mesh-net.space A
nslookup myhome.mesh-net.space

A record stuck in pending was saved but didn't reach DNS: save it again a bit later, and if it stays there, write to support.