# domain


Register custom domains for your VMs

## Usage

```
domain <add|rm|ls> ...
```

## Options

- `--json`: output in JSON format

## Examples

```
domain add my-vm app.example.com  # register a CNAME you've already set up
domain add --wildcard my-vm app.example.com  # also issue a *.example.com cert
domain ls my-vm                   # list domains on one VM
domain ls -a                      # list domains across all your VMs
domain rm my-vm app.example.com   # remove a domain
```

## Subcommands

### domain add

Link a custom domain to a VM

**Usage:**
```
domain add [--wildcard] <vm> <domain>
```

**Options:**
- `--json`: output in JSON format
- `--wildcard`: issue a wildcard (*.<parent>) certificate via DNS-01 delegation

### domain rm

Remove a custom domain from a VM

**Usage:**
```
domain rm <vm> <domain>
```

**Options:**
- `--json`: output in JSON format

### domain ls

List custom domains for a VM (or -a for all your VMs)

**Usage:**
```
domain ls <vm> | domain ls -a
```

**Options:**
- `-a`: list domains across all your VMs
- `--json`: output in JSON format