tose domain

Manage custom domains for your project.

tose domain list

List all domains configured for the project.

Synopsis

tose domain list [project]

Usage

$ tose domain list

DOMAIN                                   DNS        SSL        DEFAULT
example.com                              ok         ok         yes
www.example.com                          ok         ok
api.example.com                          pending    pending

JSON Output

$ tose domain list --json

{
  "success": true,
  "data": [
    {
      "id": "dom_abc123",
      "domain": "example.com",
      "dns_status": "ok",
      "ssl_status": "ok",
      "is_default": true
    },
    {
      "id": "dom_def456",
      "domain": "www.example.com",
      "dns_status": "ok",
      "ssl_status": "ok",
      "is_default": false
    }
  ]
}

---

tose domain add

Add a custom domain to your project.

Synopsis

tose domain add <domain>

Arguments

Argument	Description
<domain>	Domain name to add (e.g., example.com)

Usage

$ tose domain add example.com

✓ Adding domain example.com...
✓ Domain example.com added
  DNS Status: pending
  SSL Status: pending

After Adding a Domain

You need to configure DNS to point to your TOSE project. Add a CNAME record:

Type:  CNAME
Name:  example.com (or subdomain)
Value: your-project.tose.sh

Once DNS propagates, the status will change from pending to ok, and an SSL certificate will be automatically provisioned.

JSON Output

{
  "success": true,
  "data": {
    "id": "dom_abc123",
    "domain": "example.com",
    "dns_status": "pending",
    "ssl_status": "pending",
    "is_default": false
  }
}

---

tose domain rm

Remove a custom domain.

Synopsis

tose domain rm <domain> [-y]

Arguments

Argument	Description
<domain>	Domain name to remove

Options

Option	Alias	Description
--yes	-y	Skip confirmation prompt

Usage

$ tose domain rm example.com

Remove domain example.com? Yes
✓ Removing domain example.com...
✓ Domain example.com removed

Skip confirmation:

$ tose domain rm example.com -y

✓ Removing domain example.com...
✓ Domain example.com removed

JSON Output

{
  "success": true,
  "data": {
    "removed": "example.com"
  }
}

Domain Status Reference

DNS Status

Status	Description
ok	DNS is correctly configured
pending	Waiting for DNS propagation

SSL Status

Status	Description
ok	SSL certificate is active
pending	Certificate is being provisioned

TIP

DNS propagation can take up to 48 hours, but usually completes within a few minutes. SSL certificates are automatically issued once DNS is verified.

Related Commands

• tose open - Open project URL (uses default domain)
• tose status - Check project status