Install & Compatibility
Where this runs
tested against v5.6.0 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.206s · 47.2MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 4.1s · import 0.192s · 48MB
46MB installed
● package 46MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
NginxConfigurator
✓ from certbot_nginx.configurator import NginxConfigurator
✗ from certbot_nginx._internal.configurator import NginxConfigurator
Run certbot with the Nginx plugin to obtain and install a TLS certificate. For production, ensure Nginx server blocks exist before running.
import subprocess
import sys
# Unattended install of cert for example.com using certbot-nginx
result = subprocess.run([
sys.executable, '-m', 'certbot', '--nginx',
'-d', 'example.com',
'--non-interactive', '--agree-tos',
'-m', 'admin@example.com'
], capture_output=True, text=True)
print(result.stdout)
if result.returncode != 0:
print(result.stderr, file=sys.stderr)
Upgrade
Version history
5.6.0latest on PyPI · released May 11, 2026
Audit
Dependencies
certbotrequiredCore Certbot runtime; certbot-nginx is now a thin wrapper registering the plugin.
pyparsingrequiredParsing Nginx configuration files; version >=3.0.0 required.