Skip to main content

certmate-cli

The CertMate SSL certificate lifecycle from your terminal — built on certmate-sdk.

pip install certmate-cli
export CERTMATE_URL=http://localhost:8000
export CERTMATE_TOKEN=...

certmate cert create app.example.com --dns cloudflare --wait
certmate cert ls
certmate cert info app.example.com
certmate cert renew app.example.com --force
certmate cert create app.example.com --dns cloudflare --dry-run
certmate audit verify

Pulling certificates onto a host

cert download fetches one file at a time, so a target server can pull exactly what it deploys instead of the certificate manager pushing to it:

certmate cert download app.example.com --file fullchain -o /etc/ssl/certs/app.pem
certmate cert download app.example.com --file privkey   -o /etc/ssl/private/app.key

Files are created 0600, with the mode set at creation rather than after the write, so the key is never briefly world-readable.

This is worth preferring over pushing when the manager would otherwise need credentials on every target host. Give each host an API key scoped to its own domain and run the pull on a timer: the host needs no inbound access, and the manager holds no credentials for it. cert, chain and fullchain are readable by a viewer-role key; privkey, combined and pfx need operator.

--file privkey --key-format pkcs1 serves the legacy BEGIN RSA PRIVATE KEY form for stacks that reject certbot's PKCS#8. --bundle zip or --bundle json fetch the whole certificate instead, and -o - writes to stdout.

Connection comes from --url/--token or CERTMATE_URL/CERTMATE_TOKEN. Prefer the CERTMATE_TOKEN environment variable over --token: command-line arguments are visible to other local processes (ps) and shell history.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

certmate_cli-0.1.3.tar.gz (9.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

certmate_cli-0.1.3-py3-none-any.whl (9.1 kB view details)

Uploaded Python 3

File details

Details for the file certmate_cli-0.1.3.tar.gz.

File metadata

  • Download URL: certmate_cli-0.1.3.tar.gz
  • Upload date:
  • Size: 9.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for certmate_cli-0.1.3.tar.gz
Algorithm Hash digest
SHA256 a5e3f29050b317e2b17f072cd9bd3a8b6cc4458a51f466cf92eb31724038499f
MD5 2e2b08232395662fe59c9d213a45744f
BLAKE2b-256 03ac3fc0f8afcf8fd677d78ff7e3da22cbcbae50fbc75ec734d2bb1b5f7cf843

See more details on using hashes here.

Provenance

The following attestation bundles were made for certmate_cli-0.1.3.tar.gz:

Publisher: publish-clients.yml on fabriziosalmi/certmate

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file certmate_cli-0.1.3-py3-none-any.whl.

File metadata

  • Download URL: certmate_cli-0.1.3-py3-none-any.whl
  • Upload date:
  • Size: 9.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for certmate_cli-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 cfdadfa034a454076a7af77b3549d04413174bc6165b9d954c4742a3cb2f5a07
MD5 abf9ace107d8998875a8fa754d4d0b1e
BLAKE2b-256 5d46c535c5f25f641e63f12a59fe20347cd59fb6ca31073e62f94b989ef7f9a6

See more details on using hashes here.

Provenance

The following attestation bundles were made for certmate_cli-0.1.3-py3-none-any.whl:

Publisher: publish-clients.yml on fabriziosalmi/certmate

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.1.4

2 files

This release

0.1.3 This release

2 files

0.1.2

2 files

0.1.1

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page