Skip to content
Docs

basemodo domains add

Claim a hostname of yours for the App, and print the DNS records to add.

Terminal window
basemodo domains add [OPTIONS] <HOSTNAME>

Add both at the domain's DNS host: the CNAME points the hostname at Basemodo, and the TXT proves it is yours (only its value lets this App claim it). Then verify. Custom domains are on the Pro and Workspace Plans.

Arguments

  • HOSTNAME (required): The hostname, like app.example.com (a subdomain: the CNAME cannot sit at a domain's apex).
  • --app <APP>: The App whose custom domains to change. Default: the one named after the current folder.

Like every command, it also takes the global options --json and --api-url.

Examples

Give the App of this folder its own address:

Terminal window
basemodo domains add app.example.com

The same for another App:

Terminal window
basemodo domains add rota.example.com --app lunch-rota

Output

With --json, it prints {"hostname", "url", "status" (pending, issuing, active or failed), "records": [{"type", "name", "value"}], "problem", "created_at", "verified_at", "certificate_expires_at"}.

From an agent

The local MCP serves it as the tool domains_add. It changes things, so an agent's client may ask you before it runs. Its arguments are the command's, named as JSON keys: hostname (text), app (text). It answers what the command prints with --json.

Explained in