# Install dnsrobocert with Homebrew

Manage Let's Encrypt SSL certificates based on DNS challenges. Version 3.27.0 via Homebrew; verified 2026-06-20.

## Install

```sh
sudo av install brew:dnsrobocert
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install dnsrobocert
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:dnsrobocert
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/dnsrobocert>
- **Version:** 3.27.0
- **Source summary:** Manage Let's Encrypt SSL certificates based on DNS challenges
- **Homepage:** <https://dnsrobocert.readthedocs.io/en/latest/>
- **Repository:** <https://github.com/adferrand/dnsrobocert>
- **Upstream docs:** <https://adferrand.github.io/dnsrobocert>
- **License:** MIT
- **Source archive:** <https://files.pythonhosted.org/packages/6c/3f/c39c829f235a4a3694791ebf9b39d34fe49835bfcdb94162601b054e85fe/dnsrobocert-3.27.0.tar.gz>
- **Last updated:** 2026-06-20T10:48:00Z
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- dnsrobocert (cli)
- dnsrobocert (alias)

## Dependencies

- certifi
- cryptography
- libyaml
- python@3.14
- rpds-py

## Build dependencies

- rust

## Uses from macOS

- libxml2
- libxslt

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 3.27.0
- Package-manager updated: 2026-06-20
- Local data: ok
- Upstream repository: https://dnsrobocert.readthedocs.io/en/latest/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

DNSroboCert is a certificate automation tool for Let's Encrypt DNS-01 challenges. Its niche is coordinating ACME issuance, DNS provider credentials, renewal, and post-renewal hooks in one YAML-driven service.

### Project history

The GitHub repository was created in June 2017, and the first GitHub release, 1.0.0, followed later that month. The official documentation describes the design as orchestration of Certbot for certificate issuance and Lexicon for standardized DNS provider updates.

The project grew around the operational gap left by HTTP/TLS challenge tools: private services, non-web services, wildcard certificates, and deployments where opening an inbound web challenge is not practical. Its documentation emphasizes Docker support, dynamic reload of configuration, regular renewal, hooks, and DNS alias mode.

### Adoption history

DNSroboCert is packaged for Homebrew, but its official user guide presents pipx and Docker as the main installation paths. That fits its audience: self-hosters and operators who want long-running certificate automation rather than a one-shot ACME client invocation.

### How it is used

Users maintain a central YAML file, typically /etc/dnsrobocert/config.yml, with acme, profiles, and certificates sections. Profiles hold DNS provider credentials for Lexicon, certificates reference those profiles, and the service validates the file before issuing or renewing certificates.

### Why package nerds care

DNSroboCert is interesting to package maintainers because it wraps several moving parts that usually leak into local scripts: Certbot, Lexicon provider plugins, provider credentials, renewal cadence, Docker volumes, and certificate propagation hooks. Its package surface is small, but its runtime configuration is security-sensitive.

### Timeline

- 2017: GitHub repository created.
- 2017: First GitHub release, 1.0.0, published.
- 2020: Documentation examples use the 3.0.0 installation flow and container paths.
- 2026: v3.27.0 release published and Read the Docs displays DNSroboCert 3.27.0 documentation.

### Related projects

- Certbot is the underlying ACME client named by the docs. Lexicon provides the DNS provider API layer. The docs compare DNSroboCert's use case with reverse-proxy automation such as Traefik and nginx-proxy companion, and mention acme.sh DNS alias mode as related DNS challenge practice.

### Sources

- <https://dnsrobocert.readthedocs.io/en/latest/>
- <https://dnsrobocert.readthedocs.io/en/latest/user_guide.html>
- <https://dnsrobocert.readthedocs.io/en/latest/configuration_reference.html>
- <https://api.github.com/repos/adferrand/dnsrobocert>
- <https://api.github.com/repos/adferrand/dnsrobocert/releases?per_page=100>
- <https://formulae.brew.sh/formula/dnsrobocert>


## Security Notes

No matching local secret-handling manifest was found for dnsrobocert. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: /etc/dnsrobocert/config.yml

## Credential files

- Unix: /etc/dnsrobocert/config.yml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** dnsrobocert
- **Version Scheme:** 0
- **Revision:** 3
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Security and crypto packages](https://www.automicvault.com/pkg/security-crypto-tools/) - Matched security, identity, cryptography, password, signing, or certificate metadata.
- [Productivity CLI packages](https://www.automicvault.com/pkg/productivity-cli-packages/) - Matched curated productivity category metadata from av.db.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [sslmate](https://www.automicvault.com/pkg/brew/sslmate/) - Shares av.db curated category or tags: certificate-management, cli, security.
- [acme.sh](https://www.automicvault.com/pkg/brew/acme-sh/) - Shares av.db curated category or tags: acme, cli, letsencrypt, security.
- [certbot](https://www.automicvault.com/pkg/brew/certbot/) - Shares av.db curated category or tags: acme, cli, letsencrypt, security.
- [dnsgen](https://www.automicvault.com/pkg/brew/dnsgen/) - Shares av.db curated category or tags: cli, dns, security.
- [dnsmap](https://www.automicvault.com/pkg/brew/dnsmap/) - Shares av.db curated category or tags: cli, dns, security.
- [dnstwist](https://www.automicvault.com/pkg/brew/dnstwist/) - Shares av.db curated category or tags: cli, dns, security.
- [fetch-crl](https://www.automicvault.com/pkg/brew/fetch-crl/) - Shares av.db curated category or tags: certificate-management, cli, security.
- [fierce](https://www.automicvault.com/pkg/brew/fierce/) - Shares av.db curated category or tags: cli, dns, security.
- [bbot](https://www.automicvault.com/pkg/brew/bbot/) - Both packages touch the same language runtime or ecosystem. Shared terms: automation, certifi, cli, cryptography, libyaml.
- [showcert](https://www.automicvault.com/pkg/brew/showcert/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, certificate, certificates, cli, cryptography.

## Combined YAML source

View the package source record on GitHub. [combined/dnsrobocert.yml](https://github.com/automic-vault/db/blob/main/combined/dnsrobocert.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
