All docs

Domains and DNS

Buy a name from us, or point one you already own, and manage the records under it.

Buying one

marina domains search myshop
marina domains buy myshop.com

Buying is the one purchase on Marina that does not finish while you wait. buy reserves the name, holds the price against your wallet, and answers immediately with an order:

Reserved myshop.com.
Registration finishes shortly. Check with `marina domains order <id>`.

--wait polls until it settles instead. A timeout there is not a failure and exits 0: the order carries on without the command. A registration that genuinely fails exits 1, and nothing is charged.

It is also the one purchase an MCP client is asked to confirm, because it is the only thing we sell that cannot be undone.

Pointing one at an app

marina domains attach myshop.com --target shop

What happens next depends on who hosts the domain’s DNS.

If it came from us, or you transferred it in, we already host the zone. The record is written and the route published in that one call, and the domain is live when the command returns.

If you own it elsewhere, Marina prints the exact records to add wherever it is hosted:

Added shop.example.com.

Add these DNS records where your domain is hosted:
  CNAME  shop            cname.marinahost.app
  TXT    _marina-verify  <token>

Then run `marina domains verify <id>`.

Once those resolve, verify publishes the route and issues the certificate. HTTPS is automatic; there is nothing to buy or renew.

Records

A domain you bought from us, or transferred in, has its DNS here already. There is nothing to set up and no zone to create; the first command lists what you have and gives you the id the others take.

marina dns zones
marina dns records <zone>
marina dns add <zone> --type A --name @ --content 203.0.113.10
marina dns update <zone> <record> --content 203.0.113.11
marina dns remove <zone> <record>

Everything after the first line acts on a record. --name @ means the domain itself, anything else is a subdomain, --type takes A, AAAA, CNAME, TXT, MX and the rest, and MX takes --priority.

A domain you keep at another provider is not listed here, because its records live where you host it. Point it at Marina with domains attach and manage the records there.

What you own

marina domains list

Names still being registered appear here too, marked reserving. A domain you have paid for is yours whether or not registration has finished, so there is no second place to look while you wait.