Documentation missing python3-dev for Ubuntu 24.04

The quick start documentation on the site does not list python3-dev in the "install dependencies" step for Ubuntu. On a fresh Ubuntu 24.04 install it fails at the step "Install certbot" with the following error:

  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-nng8r_ot/overlay/lib/python3.12/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-312/augeas
      copying augeas/ffi.py -> build/lib.linux-x86_64-cpython-312/augeas
      copying augeas/__init__.py -> build/lib.linux-x86_64-cpython-312/augeas
      running build_ext
      generating cffi module 'build/temp.linux-x86_64-cpython-312/_augeas.c'
      creating build/temp.linux-x86_64-cpython-312
      building '_augeas' extension
      creating build/temp.linux-x86_64-cpython-312/build/temp.linux-x86_64-cpython-312
      x86_64-linux-gnu-gcc -fno-strict-overflow -Wsign-compare -DNDEBUG -g -O2 -Wall -fPIC -I/usr/include/libxml2 -I/opt/certbot/include -I/usr/include/python3.12 -c build/temp.linux-x86_64-cpython-312/_augeas.c -o build/temp.linux-x86_64-cpython-312/build/temp.linux-x86_64-cpython-312/_augeas.o
      build/temp.linux-x86_64-cpython-312/_augeas.c:50:14: fatal error: pyconfig.h: No such file or directory
         50 | #    include <pyconfig.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)

Installing python3-dev fixes this error.

2 Likes

Welcome to the Let's Encrypt Community! :slightly_smiling_face:

@certbot-devs

Bringing this to your attention.

3 Likes

Is that related to this one?

2 Likes

That is about libaugeas-dev, whereas I needed python3-dev (which someone commented on at the end of the bug, it's a separate issue.)

1 Like

Fair enough. I am not a Certbot pip packaging expert :slight_smile:

You might be better off posting at the EFF github rather than here. Their devs check that more frequently than here it seems.

The Site Feedback section you posted in is for Let's Encrypt website feedback. Not so much for EFF's Certbot. Easy to not know the difference. I do think you'd be better off posting there.

3 Likes

Thank you, we are on it. Will create an issue and amend.

6 Likes

Much appreciated, thanks!

2 Likes