Shipholm
Sign inStart free

Docs

App addresses and your own domain

Every app is reachable over HTTPS the moment it is ready. Adding your own domain takes two DNS records – and works the same whether your agent does it or you do.

The address every app gets

https://<app>.shipholm.dev

For example https://shop.shipholm.dev. Names are shared by everyone on Shipholm and first come, first served: if shop is taken, your app gets shop-01. You can rename it any time in the portal (Address – it checks the name is free when you save) or let your agent do it (check_host, then update_app with host). Your account name never appears in the address.

Your own domain, two ways

Through your agent

  1. Ask: “Add shop.example.com to the shop app.” The agent calls add_domain and tells you two DNS records.
  2. Create the records at your DNS provider.
  3. Say “verify it.” The agent calls verify_domain.

In the portal

  1. Apps → your app → Domains, type the domain, Add domain.
  2. Copy the two records to your DNS provider.
  3. Press Verify.

The two records

TypeNameValueWhy
TXT_shipholm.shop.example.comshipholm-verify=…Proves that you control the domain
CNAMEshop.example.comshop.shipholm.devSends visitors to your app

A root domain such as example.com cannot have a CNAME; you get A records instead (one per address shown).

Cloudflare: set the record to “DNS only” (grey cloud) so the certificate can be issued.

After verification