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.4.tar.gz (9.4 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.4-py3-none-any.whl (9.4 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for certmate_cli-0.1.4.tar.gz
Algorithm Hash digest
SHA256 a35831bc8d5113d7424beef9d13eff91386df6034c66eb0b3ed8006970c3b42e
MD5 2fc9be679ac62c34e46d1671f988a332
BLAKE2b-256 7c4c24eb38573027f9ce9ea21d65946953f9e04264eaff16137a0d8cbddf7d80

See more details on using hashes here.

Provenance

The following attestation bundles were made for certmate_cli-0.1.4.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.4-py3-none-any.whl.

File metadata

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

File hashes

Hashes for certmate_cli-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 1ab19a679a24ffb3a0891d12c5b3162be834c7cc5ac6009191da483d0d7ef377
MD5 68ffcf1e0d914278a222b1088006de98
BLAKE2b-256 a39646cf2cdcf3024c3a072e4ea3f39a99ded705bd70abe42e8e5698cdc1a450

See more details on using hashes here.

Provenance

The following attestation bundles were made for certmate_cli-0.1.4-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

This release

0.1.4 This release

2 files

0.1.3

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