Certbot pip Missing requirement

Please fill out the fields below so we can help you better. Note: you must provide your domain name to get help. Domain names for issued certificates are all made public in Certificate Transparency logs (e.g. crt.sh | example.com), so withholding your domain name here does not increase secrecy, but only makes it harder for us to provide help.

My domain is: NA.

I ran this command:

Certbot Instructions :

$ sudo /opt/certbot/bin/pip install --upgrade pip

It produced this output:

$ sudo /opt/certbot/bin/pip install certbot certbot-apache
Collecting certbot
Downloading certbot-4.0.0-py3-none-any.whl.metadata (8.1 kB)
Collecting certbot-apache
Downloading certbot_apache-4.0.0-py3-none-any.whl.metadata (1.5 kB)
Collecting acme>=4.0.0 (from certbot)
Downloading acme-4.0.0-py3-none-any.whl.metadata (1.5 kB)
Requirement already satisfied: ConfigArgParse>=1.5.3 in /opt/certbot/lib/python3.11/site-packages (from certbot) (1.7)
Requirement already satisfied: configobj>=5.0.6 in /opt/certbot/lib/python3.11/site-packages (from certbot) (5.0.9)
Collecting cryptography>=43.0.0 (from certbot)
Downloading cryptography-44.0.3-cp39-abi3-manylinux_2_34_x86_64.whl.metadata (5.7 kB)
Requirement already satisfied: distro>=1.0.1 in /opt/certbot/lib/python3.11/site-packages (from certbot) (1.9.0)
Collecting josepy>=2.0.0 (from certbot)
Downloading josepy-2.0.0-py3-none-any.whl.metadata (1.6 kB)
Requirement already satisfied: parsedatetime>=2.4 in /opt/certbot/lib/python3.11/site-packages (from certbot) (2.6)
Requirement already satisfied: pyrfc3339 in /opt/certbot/lib/python3.11/site-packages (from certbot) (2.0.1)
Requirement already satisfied: pytz>=2019.3 in /opt/certbot/lib/python3.11/site-packages (from certbot) (2025.2)
Collecting python-augeas (from certbot-apache)
Downloading python-augeas-1.2.0.tar.gz (99 kB)
Installing build dependencies ... done
Getting requirements to build wheel ... done
Installing backend dependencies ... done
Preparing metadata (pyproject.toml) ... done
Collecting PyOpenSSL>=25.0.0 (from acme>=4.0.0->certbot)
Downloading pyOpenSSL-25.0.0-py3-none-any.whl.metadata (16 kB)
Requirement already satisfied: requests>=2.20.0 in /opt/certbot/lib/python3.11/site-packages (from acme>=4.0.0->certbot) (2.32.3)
Requirement already satisfied: cffi>=1.12 in /opt/certbot/lib/python3.11/site-packages (from cryptography>=43.0.0->certbot) (1.17.1)
Requirement already satisfied: pycparser in /opt/certbot/lib/python3.11/site-packages (from cffi>=1.12->cryptography>=43.0.0->certbot) (2.22)
Requirement already satisfied: typing-extensions>=4.9 in /opt/certbot/lib/python3.11/site-packages (from PyOpenSSL>=25.0.0->acme>=4.0.0->certbot) (4.13.2)
Requirement already satisfied: charset-normalizer<4,>=2 in /opt/certbot/lib/python3.11/site-packages (from requests>=2.20.0->acme>=4.0.0->certbot) (3.4.2)
Requirement already satisfied: idna<4,>=2.5 in /opt/certbot/lib/python3.11/site-packages (from requests>=2.20.0->acme>=4.0.0->certbot) (3.10)
Requirement already satisfied: urllib3<3,>=1.21.1 in /opt/certbot/lib/python3.11/site-packages (from requests>=2.20.0->acme>=4.0.0->certbot) (2.4.0)
Requirement already satisfied: certifi>=2017.4.17 in /opt/certbot/lib/python3.11/site-packages (from requests>=2.20.0->acme>=4.0.0->certbot) (2025.4.26)
Downloading certbot-4.0.0-py3-none-any.whl (407 kB)
Downloading certbot_apache-4.0.0-py3-none-any.whl (269 kB)
Downloading acme-4.0.0-py3-none-any.whl (96 kB)
Downloading cryptography-44.0.3-cp39-abi3-manylinux_2_34_x86_64.whl (4.2 MB)
โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ”โ” 4.2/4.2 MB 75.3 MB/s eta 0:00:00
Downloading josepy-2.0.0-py3-none-any.whl (28 kB)
Downloading pyOpenSSL-25.0.0-py3-none-any.whl (56 kB)
Building wheels for collected packages: python-augeas
Building wheel for python-augeas (pyproject.toml) ... error
error: subprocess-exited-with-error

ร— Building wheel for python-augeas (pyproject.toml) did not run successfully.
โ”‚ exit code: 1
โ•ฐโ”€> [19 lines of output]
/tmp/pip-build-env-86537o98/overlay/lib/python3.11/site-packages/setuptools/_distutils/dist.py:289: UserWarning: Unknown distribution option: 'test_suite'
warnings.warn(msg)
running bdist_wheel
running build
running build_py
creating build/lib.linux-x86_64-cpython-311/augeas
copying augeas/ffi.py -> build/lib.linux-x86_64-cpython-311/augeas
copying augeas/init.py -> build/lib.linux-x86_64-cpython-311/augeas
running build_ext
generating cffi module 'build/temp.linux-x86_64-cpython-311/_augeas.c'
creating build/temp.linux-x86_64-cpython-311
building '_augeas' extension
creating build/temp.linux-x86_64-cpython-311/build/temp.linux-x86_64-cpython-311
x86_64-linux-gnu-gcc -Wsign-compare -DNDEBUG -g -fwrapv -O2 -Wall -g -fstack-protector-strong -Wformat -Werror=format-security -g -fwrapv -O2 -fPIC -I/opt/certbot/include -I/usr/include/python3.11 -c build/temp.linux-x86_64-cpython-311/_augeas.c -o build/temp.linux-x86_64-cpython-311/build/temp.linux-x86_64-cpython-311/_augeas.o
build/temp.linux-x86_64-cpython-311/_augeas.c:574:25: fatal error: augeas.h: No such file or directory
574 | #include <augeas.h>
| ^~~~~~~~~~
compilation terminated.
error: command '/usr/bin/x86_64-linux-gnu-gcc' failed with exit code 1
[end of output]

note: This error originates from a subprocess, and is likely not a problem with pip.
ERROR: Failed building wheel for python-augeas
Failed to build python-augeas
ERROR: Failed to build installable wheels for some pyproject.toml based projects (python-augeas)
rc=1

Because of missing development files for a library, please add it to the instructional web page.

 sudo apt install libaugeas-dev

My web server is (include version): apache2 2.4.62-1~deb12u2

The operating system my web server runs on is (include version): Debian 12.10 Bookworm

My hosting provider, if applicable, is: NA.

I can login to a root shell on my machine (yes or no, or I don't know): yes.

I'm using a control panel to manage my site (no, or provide the name and version of the control panel): no.

The version of my client is (e.g. output of certbot --version or certbot-auto --version if you're using Certbot):

$ /usr/bin/certbot --version
certbot 4.0.0
$

Same issue here, something must have changed very recently.

I am no Certbot pip packaging expert but this may be better handled at the EFF's github for Certbot: GitHub ยท Where software is built

That said, other volunteers may know more and offer assistance here. If you don't see any other suggestions here definitely try their github

3 Likes

Having the same problem. I created an issue.

2 Likes

It has been fixed with the libaugeas-dev package marked as required.

1 Like