# Install certbot with Homebrew, apk, apt, dnf, MacPorts, Nix, pacman, winget, zypper

Tool to obtain certs from Let's Encrypt and autoenable HTTPS. Version 5.6.0 via Homebrew; verified 2026-05-20.

## Install

```sh
sudo av install brew:certbot
```

## Agent safety answer

certbot manages TLS certificates and can change web-server certificate state.

- **Credential access:** Reads account keys, private keys, webroot paths, and DNS provider credentials.
- **Remote mutation:** Can request certificates and modify local server config or DNS plugins.
- **Publish/artifact risk:** Can create certificates used by public services.
- **Recommended control:** Gate renew, certonly, private-key reads, and DNS credential use.
- **Agent-use guidance:** Allow certificate status checks; require approval before issuing, renewing, or editing live certs.

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install certbot
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install certbot
```

  Evidence: MacPorts ports tree: security/certbot/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add certbot
```

  Evidence: Alpine Linux edge package indexes: certbot from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install certbot
```

  Evidence: Debian stable package indexes: certbot from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install certbot
```

  Evidence: Fedora Rawhide package metadata: certbot from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#certbot
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ce/certbot/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- pacman (92%):

```sh
sudo pacman -S certbot
```

  Evidence: Arch Linux sync databases: certbot from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz

- zypper (92%):

```sh
sudo zypper install python311-certbot
```

  Evidence: openSUSE Tumbleweed package metadata: python311-certbot from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

### Windows

- winget (92%):

```sh
winget install --id EFF.Certbot -e
```

  Evidence: Windows Package Manager source index: EFF.Certbot from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:certbot
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/certbot>
- **Version:** 5.6.0
- **Source summary:** Tool to obtain certs from Let's Encrypt and autoenable HTTPS
- **Homepage:** <https://certbot.eff.org/>
- **Repository:** <https://github.com/certbot/certbot>
- **Upstream docs:** <https://certbot.eff.org/docs>
- **License:** Apache-2.0
- **Source archive:** <https://files.pythonhosted.org/packages/4b/c0/838942a6c5fb07e42fdf48a5cc306214fd118c98dae673f1fb0b2d1f88ef/certbot-5.6.0.tar.gz>
- **Last updated:** 2026-05-20T11:26:15Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- certbot (cli)
- certbot (alias)

## Dependencies

- augeas
- certifi
- cryptography
- libyaml
- pydantic
- python@3.14

## Uses from macOS

- libffi

## 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: 5.6.0
- Package-manager updated: 2026-05-20
- Local data: ok
- Upstream repository: https://certbot.eff.org/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

Certbot is EFF's ACME client for obtaining and renewing HTTPS certificates, most commonly from Let's Encrypt, and optionally configuring web servers such as Apache and nginx.

### Project history

The repository was created in 2014 during the early Let's Encrypt client era. In 2016, EFF announced the client would move under the Certbot name to distinguish the client from the Let's Encrypt certificate authority and ISRG organization.

### Adoption history

Certbot rode the same adoption wave as Let's Encrypt: EFF's 2016 announcement noted Let's Encrypt had issued its three millionth certificate, and EFF later reported Certbot installed on more than 4 million web servers maintaining certificates for more than 31 million websites.

### How it is used

Certbot is intended to run on the server that hosts the site. It obtains certificates, saves them under /etc/letsencrypt/live, renews them on a schedule, and can use plugins for Apache, nginx, webroot, standalone, manual, and DNS-based validation.

### Why package nerds care

Certbot is one of the canonical examples of a security CLI becoming distribution infrastructure: it appears in many package managers, replaced the older letsencrypt command name in user documentation, deprecated certbot-auto, and standardized operational files under /etc/letsencrypt.

### Timeline

- 2014: Public certbot/certbot repository created.
- 2016: EFF announced the Let's Encrypt client rename to Certbot and the new certbot.eff.org site.
- 2025: Certbot 5.0.0 released, removing older deprecated APIs and Python 3.9 support.
- 2026: Certbot 5.6.0 released according to the official changelog.

### Related projects

- Let's Encrypt is the default certificate authority commonly used with Certbot.
- ACME is the protocol Certbot speaks, standardized as RFC 8555.
- certbot-apache, certbot-nginx, and Certbot DNS plugins provide authenticator and installer integrations.

### Sources

- <https://api.github.com/repos/certbot/certbot>
- <https://github.com/certbot/certbot>
- <https://certbot.eff.org/>
- <https://certbot.eff.org/docs>
- <https://www.eff.org/deeplinks/2016/05/announcing-certbot-new-tls-robot>
- <https://www.eff.org/deeplinks/2024/03/should-caddy-and-traefik-replace-certbot>
- <https://github.com/certbot/certbot/blob/main/certbot/CHANGELOG.md>
- <https://formulae.brew.sh/api/formula/certbot.json>


## Security Notes

No matching local secret-handling manifest was found for certbot. 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.


## Credential files

- macOS: ~/Library/Application Support/letsencrypt
- Unix: ~/.config/letsencrypt, ~/.letsencrypt
## Source Database Details

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

## Other Package-Manager Records

- Debian apt - certbot - 4.0.0-2+deb13u1: normalized package name match | Debian stable package indexes: certbot from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | automatically configure HTTPS using Let's Encrypt | https://certbot.eff.org/
- Nix - certbot: normalized package name match | nixpkgs package indexes: pkgs/by-name/ce/certbot/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - certbot - 2.9.0-1: normalized package name match | Ubuntu 24.04 LTS package indexes: certbot from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | automatically configure HTTPS using Let's Encrypt | https://certbot.eff.org/
- apk - certbot - 5.6.0-r0: normalized package name match | Alpine Linux edge package indexes: certbot from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | An ACME client that can update Apache/Nginx configurations | https://github.com/certbot/certbot
- apk - certbot-pyc - 5.6.0-r0: normalized package name match | Alpine Linux edge package indexes: certbot-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for certbot | https://github.com/certbot/certbot
- dnf - certbot - 5.6.0-1.fc45: normalized package name match | Fedora Rawhide package metadata: certbot from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | A free, automated certificate authority client | https://github.com/certbot/certbot
- dnf - python-acme-doc - 5.6.0-1.fc45: normalized package name match | Fedora Rawhide package metadata: python-acme-doc from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Documenation for python-acme-doc libraries | https://github.com/certbot/certbot
- dnf - python-certbot-dns-cloudflare-doc - 5.6.0-1.fc45: normalized package name match | Fedora Rawhide package metadata: python-certbot-dns-cloudflare-doc from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Documenation for python-certbot-dns-cloudflare-doc libraries | https://github.com/certbot/certbot
- dnf - python-certbot-dns-digitalocean-doc - 5.6.0-1.fc45: normalized package name match | Fedora Rawhide package metadata: python-certbot-dns-digitalocean-doc from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Documenation for python-certbot-dns-digitalocean-doc libraries | https://github.com/certbot/certbot
- dnf - python-certbot-dns-dnsimple-doc - 5.6.0-1.fc45: normalized package name match | Fedora Rawhide package metadata: python-certbot-dns-dnsimple-doc from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Documenation for python-certbot-dns-dnsimple-doc libraries | https://github.com/certbot/certbot
- dnf - python-certbot-dns-dnsmadeeasy-doc - 5.6.0-1.fc45: normalized package name match | Fedora Rawhide package metadata: python-certbot-dns-dnsmadeeasy-doc from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Documenation for python-certbot-dns-dnsmadeeasy-doc libraries | https://github.com/certbot/certbot
- dnf - python-certbot-dns-gehirn-doc - 5.6.0-1.fc45: normalized package name match | Fedora Rawhide package metadata: python-certbot-dns-gehirn-doc from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Documenation for python-certbot-dns-gehirn-doc libraries | https://github.com/certbot/certbot
- dnf - python-certbot-dns-google-doc - 5.6.0-1.fc45: normalized package name match | Fedora Rawhide package metadata: python-certbot-dns-google-doc from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Documenation for python-certbot-dns-google-doc libraries | https://github.com/certbot/certbot
- dnf - python-certbot-dns-linode-doc - 5.6.0-1.fc45: normalized package name match | Fedora Rawhide package metadata: python-certbot-dns-linode-doc from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Documenation for python-certbot-dns-linode-doc libraries | https://github.com/certbot/certbot
- dnf - python-certbot-dns-luadns-doc - 5.6.0-1.fc45: normalized package name match | Fedora Rawhide package metadata: python-certbot-dns-luadns-doc from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Documenation for python-certbot-dns-luadns-doc libraries | https://github.com/certbot/certbot
- dnf - python-certbot-dns-nsone-doc - 5.6.0-1.fc45: normalized package name match | Fedora Rawhide package metadata: python-certbot-dns-nsone-doc from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Documenation for python-certbot-dns-nsone-doc libraries | https://github.com/certbot/certbot


## 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.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [augeas](https://www.automicvault.com/pkg/brew/augeas/) - Runtime dependency declared by Homebrew.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [acme.sh](https://www.automicvault.com/pkg/brew/acme-sh/) - Shares av.db curated category or tags: acme, certificates, cli, letsencrypt, security.
- [lego](https://www.automicvault.com/pkg/brew/lego/) - Shares av.db curated category or tags: acme, certificates, cli, letsencrypt, security.
- [mkcert](https://www.automicvault.com/pkg/brew/mkcert/) - Shares av.db curated category or tags: certificates, cli, https, security, tls.
- [showcert](https://www.automicvault.com/pkg/brew/showcert/) - Shares av.db curated category or tags: certificates, cli, letsencrypt, security, tls.
- [certgraph](https://www.automicvault.com/pkg/brew/certgraph/) - Shares av.db curated category or tags: certificates, cli, security, tls.
- [certigo](https://www.automicvault.com/pkg/brew/certigo/) - Shares av.db curated category or tags: certificates, cli, security, tls.
- [certstrap](https://www.automicvault.com/pkg/brew/certstrap/) - Shares av.db curated category or tags: certificates, cli, security, tls.
- [crip](https://www.automicvault.com/pkg/brew/crip/) - Shares av.db curated category or tags: certificates, cli, security, tls.
- [dnsrobocert](https://www.automicvault.com/pkg/brew/dnsrobocert/) - Both packages touch the same language runtime or ecosystem. Shared terms: acme, certifi, certificates, cli, cryptography.

## Combined YAML source

View the package source record on GitHub. [combined/certbot.yml](https://github.com/automic-vault/db/blob/main/combined/certbot.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
- external package-manager database matches
- cross-ecosystem install command graph
- curated agent safety answer
