Underpass
Easy names

Type the name.
Not the address.
Every device, every app.

Every device and internal app in your network gets a simple name, like db-prod or grafana. It works the moment a device joins, on every device, with nothing to set up.

You type

ssh deploy@db-prod

  1. Asks

    What is db-prod?

    your laptop

  2. Answered by

    This device

    nothing leaves it

  3. Answer

    100.64.0.21

    machine

db-prod · Linux server in the office

Anatomy of a name

Short when you want it.
Complete when you need it.

Every machine has a short name and a full one. Both work from any device in your network.

db-prod.acme.your-domain

The machine

Its name. Rename it in the dashboard any time.

Your network

A name you choose for your whole network.

Shared domain

The same for every network.

Most of the time you only need the first part: db-prod works on its own. The full name is there for tools that want one, and for HTTPS certificates.

Names that keep up

Names follow the machine.
Not the other way round.

Devices come and go, get renamed and get new addresses. The names keep up on their own.

01

A device joins

It gets a name the moment it's approved, from its computer name. Every device can use it right away.

Machinesjust now

build-02

joined · Linux

New

build-01

Linux

Online

02

You rename it

Change the name in the dashboard, and the new one works everywhere. The change is recorded in the activity log.

Rename machine

Name

desktop-7f3k2design-pc
Save

03

Its address changes

Reinstall a machine or add it again, and it may get a new address. The name follows, so nothing else changes.

db-prod

100.64.0.21

before

100.64.0.58

now · same name

Your own DNS

Already have DNS?
It still works.

Your network's names are answered first. Everything else goes wherever you say.

  • NameserversSend every lookup from your devices to the DNS servers you choose.
  • Split DNSSend one domain, like corp.internal, to its own servers. Up to 32 domains.
  • Search domainsLet short names like printer find printer.office.example. Up to 16.
DNSAcme

Network name

acme

Nameservers

1.1.1.19.9.9.9

Split DNS

corp.internal

→ 10.0.0.53

aws.internal

→ 10.20.0.2

Search domains

office.example
HTTPS certificates
HTTPS
root@grafana-box

$ sudo underpass cert

Certificate: /var/lib/underpass/certs/grafana-box.crt

Key: /var/lib/underpass/certs/grafana-box.key

It renews automatically while underpass runs.

Real HTTPS.
No browser warnings.

Turn on HTTPS in your DNS settings, then one command gets a trusted certificate for the machine's full name. It renews on its own.

!

Trusted certificates are public record, so a machine's full name becomes public once it has one. Pick names you're happy to share.

FAQ

Questions about names.

Something we didn't cover? Write to us and we'll help you get set up.

Ask us anything
  • No. Names work as soon as a device joins. Underpass answers them on each device, so there's no DNS server to run.

More features

/ Independent · bootstrapped · no investors

Built by a person,
not a fund.

I'm Endi, and I build Underpass myself. No investors to answer to, only the people who run their networks on it. Every message that comes in reaches me directly.