# noust domain

Serve an application on more domains: aliases and redirects.

```bash
noust domain [OPTIONS] COMMAND [ARGS]...
```

Subcommands: [`add`](#noust-domain-add), [`canonical`](#noust-domain-canonical), [`certificate`](#noust-domain-certificate), [`disable`](#noust-domain-disable), [`enable`](#noust-domain-enable), [`list`](#noust-domain-list), [`port`](#noust-domain-port), [`remove`](#noust-domain-remove), [`temporary`](#noust-domain-temporary)

## noust domain add

Make APP answer on DOMAIN too.

```bash
noust domain add [OPTIONS] APP DOMAIN
```

Arguments: `app_domain`, `domain`

| Option | What it does | Default |
|---|---|---|
| `--kind` | alias serves the application on DOMAIN; redirect sends DOMAIN to APP. | `alias` |
| `--no-cert` | Do not extend the certificate now. Run the same command again to extend it. |  |
| `--port` | Proxy this name to another port of the application than its own (an alias). |  |
| `--force` | Add the name although another site of the web server already answers on it. |  |
| `--no-dns` | Do not point the name at this server in the DNS account that holds its zone. |  |
| `--own-certificate` | Give DOMAIN a certificate of its own instead of covering it with APP's. |  |
| `--dns` | With --own-certificate: prove it with a DNS record in ACCOUNT (a wildcard needs it). |  |
| `--http` | With --own-certificate: prove it over HTTP (the default). |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust domain canonical

Choose whether www.<domain> or <domain> is served; the other one redirects to it.

```bash
noust domain canonical [OPTIONS] APP {www|apex|none}
```

Arguments: `app_domain`, `spelling`

| Option | What it does | Default |
|---|---|---|
| `--no-cert` | Do not extend the certificate to cover both names now. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust domain certificate

Make APP's certificate cover exactly the names it answers on, or say how one name is covered.

```bash
noust domain certificate [OPTIONS] APP [NAME]
```

Arguments: `app_domain`, `name`

| Option | What it does | Default |
|---|---|---|
| `--own` | Give NAME a certificate of its own, kept under its own name. |  |
| `--shared` | Cover NAME with APP's certificate again, and delete the one it had. |  |
| `--dns` | With --own: prove it with a DNS record in ACCOUNT (a wildcard needs it). |  |
| `--http` | With --own: prove it over HTTP. |  |
| `--reduce` | Order it again with only the names the application answers on (after a removal). |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust domain disable

Stop APP answering on DOMAIN without forgetting it.

```bash
noust domain disable [OPTIONS] APP DOMAIN
```

Arguments: `app_domain`, `domain`

| Option | What it does | Default |
|---|---|---|
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust domain enable

Serve DOMAIN again, after 'noust domain disable'.

```bash
noust domain enable [OPTIONS] APP DOMAIN
```

Arguments: `app_domain`, `domain`

| Option | What it does | Default |
|---|---|---|
| `--no-cert` | Do not extend the certificate now. Run the command again to. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust domain list

List the domains APP answers on.

```bash
noust domain list [OPTIONS] APP
```

Arguments: `app_domain`

| Option | What it does | Default |
|---|---|---|
| `--json` | Print the domains as JSON. |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust domain port

Proxy an alias to another port of the application, or back to its own with 'none'.

```bash
noust domain port [OPTIONS] APP DOMAIN PORT|none
```

Arguments: `app_domain`, `domain`, `port`

| Option | What it does | Default |
|---|---|---|
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust domain remove

Stop APP answering on DOMAIN.

```bash
noust domain remove [OPTIONS] APP DOMAIN
```

Arguments: `app_domain`, `domain`

| Option | What it does | Default |
|---|---|---|
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |

## noust domain temporary

Give APP a temporary name made of this server's address, for a server with no domain yet.

```bash
noust domain temporary [OPTIONS] APP
```

Arguments: `app_domain`

| Option | What it does | Default |
|---|---|---|
| `--show` | Only say the name, without adding it to anything. |  |
| `--prefix` | Make the name of one application (shop.203-0-113-10.sslip.io) instead of the server's own, numbered when another application has it. |  |
| `--no-cert` | Do not extend the certificate now. Run the same command again to extend it. |  |
| `--json` | Print the name as JSON (with --show). |  |
| `--reason` | Why this change is made (a change reference, a ticket). Recorded with the command in the audit log; required only where a compliance framework asks for it (ENS) or security.change_reasons is on. |  |