---
title: "ezgh certificates request"
description: "Request a public certificate."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.ezghcloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ezgh certificates request

{/* Generated by ezgh-cli's internal/tools/clidocs from the ezgh command tree. Don't edit: change the command's help in ezgh-cli and regenerate. */}

```sh
ezgh certificates request <name>... [--dns-zone zone|auto] [--name n] [--wait] [flags]
```

Request a public certificate for one or more names. Each name needs a domain authorization: one is created for a name without, and with `--dns-zone` (a zon\_… ID, a zone's domain, or auto for the project's zone that covers each name) EZGH writes its validation records into that zone, linking an existing authorization that isn't linked yet. Needs dns.records.update on the zone.

`--wait` waits for the request to finish (at most `--wait-timeout`, 10 minutes by default).

Part of [`ezgh certificates`](/cli/reference/certificates).

## Examples

```sh
ezgh certificates request www.example.com api.example.com --dns-zone auto --wait
```

## Flags

| Flag | Type | Default | Description |
| --- | --- | --- | --- |
| `--dns-zone` | string |  | write validation records into this EZGH DNS zone (zon\_… ID, domain, or auto) |
| `--name` | string |  | the certificate's name (default: the first name) |
| `--wait` | boolean |  | wait until the request finishes |
| `--wait-timeout` | duration | `10m0s` | how long `--wait` waits |

This command also takes the [global flags](/cli/reference#global-flags).

Source: https://docs.ezghcloud.com/cli/reference/certificates-request/index.mdx
