sota domains

Manage custom domains for the current project. Each project supports up to 5 custom domains with automatic HTTPS via Let's Encrypt.

Usage

sota domains list
sota domains add <domain>
sota domains get <domain-id>
sota domains remove <domain-id>

Commands

List Domains

$ sota domains list
DOMAIN              STATUS    ID
app.example.com     active    d47e8f9a-1234-5678-...
example.com         pending   a1b2c3d4-5678-9012-...

Lists all custom domains for the current project with their status and ID.

Add a Domain

$ sota domains add app.example.com
Domain added: app.example.com
  Status: pending

DNS Setup Required:
  Record Type: CNAME
  Name: app
  Value: my-project.sota.io

After adding the DNS record, the domain will be verified
automatically and SSL provisioned via Let's Encrypt.

Adds a custom domain and returns DNS instructions. Configure the DNS record at your registrar to complete setup.

Get Domain Details

$ sota domains get d47e8f9a-1234-5678-9abc-def012345678
Domain: app.example.com
  ID: d47e8f9a-1234-5678-9abc-def012345678
  Status: active
  Type: CNAME
  Verified: 2026-03-01T10:02:00Z

Shows domain details including status and DNS instructions.

Remove a Domain

$ sota domains remove d47e8f9a-1234-5678-9abc-def012345678
Domain d47e8f9a-1234-5678-9abc-def012345678 removed.

Removes a custom domain. DNS records at your registrar must be cleaned up manually.

DNS Configuration

After adding a domain, configure DNS at your registrar:

Domain Type	Record	Name	Value
Apex (example.com)	A	@	23.88.45.28
Subdomain (app.example.com)	CNAME	app	your-slug.sota.io

Note: DNS propagation can take up to 48 hours. sota.io checks automatically until verification succeeds.