`heroku certs`
==============

SSL certificates

* [`heroku certs`](#heroku-certs)
* [`heroku certs:add CRT KEY`](#heroku-certsadd-crt-key)
* [`heroku certs:auto`](#heroku-certsauto)
* [`heroku certs:auto:disable`](#heroku-certsautodisable)
* [`heroku certs:auto:enable`](#heroku-certsautoenable)
* [`heroku certs:auto:refresh`](#heroku-certsautorefresh)
* [`heroku certs:generate DOMAIN`](#heroku-certsgenerate-domain)
* [`heroku certs:info`](#heroku-certsinfo)
* [`heroku certs:remove`](#heroku-certsremove)
* [`heroku certs:update CRT KEY`](#heroku-certsupdate-crt-key)

## `heroku certs`

list SSL certificates for an app

```
USAGE
  $ heroku certs -a <value> [--prompt] [-r <value>]

FLAGS
  -a, --app=<value>     (required) [env: HEROKU_APP] app to run command against
  -r, --remote=<value>  git remote of app to use

GLOBAL FLAGS
  --prompt  interactively prompt for command arguments and flags

DESCRIPTION
  list SSL certificates for an app
```

_See code: [src/commands/certs/index.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/certs/index.ts)_

## `heroku certs:add CRT KEY`

Add an SSL certificate to an app.

```
USAGE
  $ heroku certs:add CRT KEY -a <value> [--prompt] [-r <value>]

ARGUMENTS
  CRT  absolute path of the certificate file on disk
  KEY  absolute path of the key file on disk

FLAGS
  -a, --app=<value>     (required) [env: HEROKU_APP] app to run command against
  -r, --remote=<value>  git remote of app to use

GLOBAL FLAGS
  --prompt  interactively prompt for command arguments and flags

DESCRIPTION
  Add an SSL certificate to an app.

  Note: certificates with PEM encoding are also valid.


EXAMPLES
   $ heroku certs:add example.com.crt example.com.key 
  If you require intermediate certificates, refer to this article on merging certificates to get a complete chain:
  https://help.salesforce.com/s/articleView?id=000333504&type=1
```

_See code: [src/commands/certs/add.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/certs/add.ts)_

## `heroku certs:auto`

show ACM status for an app

```
USAGE
  $ heroku certs:auto -a <value> [--prompt] [-r <value>] [--wait]

FLAGS
  -a, --app=<value>     (required) [env: HEROKU_APP] app to run command against
  -r, --remote=<value>  git remote of app to use
      --wait            watch ACM status and display the status when complete

GLOBAL FLAGS
  --prompt  interactively prompt for command arguments and flags

DESCRIPTION
  show ACM status for an app
```

_See code: [src/commands/certs/auto/index.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/certs/auto/index.ts)_

## `heroku certs:auto:disable`

disable ACM for an app

```
USAGE
  $ heroku certs:auto:disable -a <value> [--prompt] [-r <value>]

FLAGS
  -a, --app=<value>     (required) [env: HEROKU_APP] app to run command against
  -r, --remote=<value>  git remote of app to use

GLOBAL FLAGS
  --prompt  interactively prompt for command arguments and flags

DESCRIPTION
  disable ACM for an app
```

_See code: [src/commands/certs/auto/disable.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/certs/auto/disable.ts)_

## `heroku certs:auto:enable`

enable ACM status for an app

```
USAGE
  $ heroku certs:auto:enable -a <value> [--prompt] [-r <value>] [--wait]

FLAGS
  -a, --app=<value>     (required) [env: HEROKU_APP] app to run command against
  -r, --remote=<value>  git remote of app to use
      --wait            watch ACM status and exit when complete

GLOBAL FLAGS
  --prompt  interactively prompt for command arguments and flags

DESCRIPTION
  enable ACM status for an app
```

_See code: [src/commands/certs/auto/enable.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/certs/auto/enable.ts)_

## `heroku certs:auto:refresh`

refresh ACM for an app

```
USAGE
  $ heroku certs:auto:refresh -a <value> [--prompt] [-r <value>]

FLAGS
  -a, --app=<value>     (required) [env: HEROKU_APP] app to run command against
  -r, --remote=<value>  git remote of app to use

GLOBAL FLAGS
  --prompt  interactively prompt for command arguments and flags

DESCRIPTION
  refresh ACM for an app
```

_See code: [src/commands/certs/auto/refresh.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/certs/auto/refresh.ts)_

## `heroku certs:generate DOMAIN`

generate a key and a CSR or self-signed certificate

```
USAGE
  $ heroku certs:generate DOMAIN -a <value> [--prompt] [--area <value>] [--city <value>] [--country <value>]
    [--keysize <value>] [--now] [--owner <value>] [-r <value>] [--selfsigned] [--subject <value>]

ARGUMENTS
  DOMAIN  domain name to generate

FLAGS
  -a, --app=<value>      (required) [env: HEROKU_APP] app to run command against
  -r, --remote=<value>   git remote of app to use
      --area=<value>     sub-country area (state, province, etc.) of owner
      --city=<value>     city of owner
      --country=<value>  country of owner, as a two-letter ISO country code
      --keysize=<value>  RSA key size in bits (default: 2048)
      --now              do not prompt for any owner information
      --owner=<value>    name of organization certificate belongs to
      --selfsigned       generate a self-signed certificate instead of a CSR
      --subject=<value>  specify entire certificate subject

GLOBAL FLAGS
  --prompt  interactively prompt for command arguments and flags

DESCRIPTION
  generate a key and a CSR or self-signed certificate
```

_See code: [src/commands/certs/generate.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/certs/generate.ts)_

## `heroku certs:info`

show certificate information for an SSL certificate

```
USAGE
  $ heroku certs:info -a <value> [--prompt] [--endpoint <value>] [--name <value>] [-r <value>] [--show-domains]

FLAGS
  -a, --app=<value>       (required) [env: HEROKU_APP] app to run command against
  -r, --remote=<value>    git remote of app to use
      --endpoint=<value>  endpoint to check info on
      --name=<value>      name to check info on
      --show-domains      show associated domains

GLOBAL FLAGS
  --prompt  interactively prompt for command arguments and flags

DESCRIPTION
  show certificate information for an SSL certificate
```

_See code: [src/commands/certs/info.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/certs/info.ts)_

## `heroku certs:remove`

remove an SSL certificate from an app

```
USAGE
  $ heroku certs:remove -a <value> [--prompt] [--endpoint <value>] [--name <value>] [-r <value>]

FLAGS
  -a, --app=<value>       (required) [env: HEROKU_APP] app to run command against
  -r, --remote=<value>    git remote of app to use
      --endpoint=<value>  endpoint to remove
      --name=<value>      name to remove

GLOBAL FLAGS
  --prompt  interactively prompt for command arguments and flags

DESCRIPTION
  remove an SSL certificate from an app
```

_See code: [src/commands/certs/remove.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/certs/remove.ts)_

## `heroku certs:update CRT KEY`

update an SSL certificate on an app

```
USAGE
  $ heroku certs:update CRT KEY -a <value> [--prompt] [--endpoint <value>] [--name <value>] [-r <value>]

ARGUMENTS
  CRT  absolute path of the certificate file on disk
  KEY  absolute path of the key file on disk

FLAGS
  -a, --app=<value>       (required) [env: HEROKU_APP] app to run command against
  -r, --remote=<value>    git remote of app to use
      --endpoint=<value>  endpoint to update
      --name=<value>      name to update

GLOBAL FLAGS
  --prompt  interactively prompt for command arguments and flags

DESCRIPTION
  update an SSL certificate on an app
  Note: certificates with PEM encoding are also valid


EXAMPLES
  $ heroku certs:update example.com.crt example.com.key 
     If you require intermediate certificates, refer to this article on merging certificates to get a complete chain:
     https://help.salesforce.com/s/articleView?id=000333504&type=1
```

_See code: [src/commands/certs/update.ts](https://github.com/heroku/cli/blob/v11.10.0/src/commands/certs/update.ts)_