Packaging Guide¶
Releases¶
We release packages and upload them to PyPI (wheels and source tarballs).
- https://pypi.python.org/pypi/acme
- https://pypi.python.org/pypi/certbot
- https://pypi.python.org/pypi/certbot-apache
- https://pypi.python.org/pypi/certbot-nginx
- https://pypi.python.org/pypi/certbot-dns-cloudflare
- https://pypi.python.org/pypi/certbot-dns-cloudxns
- https://pypi.python.org/pypi/certbot-dns-digitalocean
- https://pypi.python.org/pypi/certbot-dns-dnsimple
- https://pypi.python.org/pypi/certbot-dns-google
- https://pypi.python.org/pypi/certbot-dns-nsone
- https://pypi.python.org/pypi/certbot-dns-route53
The following scripts are used in the process:
We use git tags to identify releases, using Semantic Versioning. For
example: v0.11.1
.
Notes for package maintainers¶
- Please use our tagged releases, not
master
! - Do not package
certbot-compatibility-test
orletshelp-certbot
- it’s only used internally. - If you’d like to include automated renewal in your package
certbot renew -q
should be added to crontab or systemd timer. Additionally you should include a random per-machine time offset to avoid having a large number of your clients hit Let’s Encrypt’s servers simultaneously. jws
is an internal script foracme
module and it doesn’t have to be packaged - it’s mostly for debugging: you can use it asecho foo | jws sign | jws verify
.- Do get in touch with us. We are happy to make any changes that will make packaging easier. If you need to apply some patches don’t do it downstream - make a PR here.
Already ongoing efforts¶
Arch¶
From our official releases:
- https://www.archlinux.org/packages/community/any/python-acme
- https://www.archlinux.org/packages/community/any/certbot
- https://www.archlinux.org/packages/community/any/certbot-apache
- https://www.archlinux.org/packages/community/any/certbot-nginx
- https://www.archlinux.org/packages/community/any/certbot-dns-cloudflare
- https://www.archlinux.org/packages/community/any/certbot-dns-cloudxns
- https://www.archlinux.org/packages/community/any/certbot-dns-digitalocean
- https://www.archlinux.org/packages/community/any/certbot-dns-dnsimple
- https://www.archlinux.org/packages/community/any/certbot-dns-google
- https://www.archlinux.org/packages/community/any/certbot-dns-nsone
- https://www.archlinux.org/packages/community/any/certbot-dns-route53
From master
: https://aur.archlinux.org/packages/certbot-git
Debian (and its derivatives, including Ubuntu)¶
Fedora¶
In Fedora 23+.
FreeBSD¶
Gentoo¶
Currently, all certbot
related packages are in the testing branch: