Dukoi
Custom domains

Custom domains

Put an app on a name like api.example.com. It stays the same across restarts, reboots and reinstalls.

What you need

A domain on Cloudflare. The free plan is fine.

Add a domain

$ npx dukoi expose --domain api.example.com
Pointing api.example.com at hono-api…

Connect the phone to Cloudflare. In the page that opens, pick example.com and click Authorize.

✓ Phone connected to example.com
Pointing api.example.com at hono-api…
✓ hono-api is public

  Public  https://api.example.com

  This URL stays the same across restarts and reboots.
  1. The first time, Cloudflare’s login opens in your browser. Pick your domain and click Authorize. The phone keeps the certificate.
  2. The phone makes one tunnel for itself and a DNS record for the name.
  3. After that, adding another name under the same domain takes a second.

You can do the same on the phone: open the app, tap Make public and pick Your domain.

Good to know

  • Every name must be under the domain you picked at login, like *.example.com.
  • A domain replaces the app’s quick link.
  • Dukoi only changes DNS records it made, and won’t take over a name that already points somewhere else.
  • dukoi expose --off removes the name and its DNS record.

Disconnect from Cloudflare

On the phone, go to Settings → Cloudflare → Disconnect. Every app loses its domain, Dukoi deletes the DNS records and tunnel it made, and the phone deletes its certificate. Add a domain again to log in fresh, or to switch to another domain.