Skip to content

Reserve a domain

Claim a Tubu hostname and wait for HTTPS readiness before publishing a service.

No local service is required. A fourth level domain such as api.my-team.tubu.dev requires available fourth level domain quota and certificate provisioning on the relay.

Reserve the exact name

npx tubu-cli reserve --domain my-app.tubu.dev

The CLI reserves the exact name and waits up to five minutes for a successful HTTPS check. Expect my-app.tubu.dev: HTTPS ready.

For a fourth level domain, reserve it before opening a tunnel:

npx tubu-cli reserve --domain api.my-team.tubu.dev

Sibling names have independent owners. Reserving my-team.tubu.dev does not reserve api.my-team.tubu.dev.

Publish your service

Start your service on port 3000.

npx tubu-cli http 3000 --domain my-app.tubu.dev

Check your service at the public root URL. A third level name can also be claimed automatically when you publish it, if it is available.

Manage reservations

A cancelled or timed out HTTPS wait leaves the reservation in place. Rerun the same command to resume the check. Repeating a reservation does not extend its expiration.

Domains expire after more than 90 days from the last tunnel opening or reconnection, or from reservation if never opened. An open tunnel alone does not refresh this time. Release a domain from your account when you no longer need it.