Welcome to the acme-dns-tiny project

Introduction

acme-dns-tiny is a python 3 script able to ask a Certificate Autority (CA) to provide automatically a X.509 certificate.

To be able to automate the certificate creation, acme-dns-tiny uses the ACME RFC 8555 standard. Indeed, to prove to the CA you are the owner of the domains included in the certificate request, acme-dns-tiny uses the DNS challenges defined by this RFC.

To resolve these challenges, acme-dns-tiny dynamically updates some DNS resources on your DNS service provider.

That's why, to be able to use acme-dns-tiny, you'll have to choose a CA which provides a service following the ACME RFC 8555, like the Let's Encrypt non-profit Certificate Authority.

The main goal of acme-dns-tiny is not to rewrite the official certbot ACME client but to give administrators a simple script easy to integrate in their environment without requiring root privileges and without access to the domain private key.

Requirements

To run acme-dns-tiny, you'll need a computer with Python 3, the dnspython module, the requests module and the OpenSSL command line available.

Then you have to give access to the non-root user running the script to:

• the ACME account private key used to authenticate with the CA
• the Certificate Signing Request (CSR) which will be used to create the certificate.
  Note: the CSR is enough, the user does not need any access to the linked private domain key.
• a config file containing path of these files and the DNS secret to manage DNS resources

Finally, that computer must be able to access a DNS server allowing dynamic resource updates through TSIG key authentication.

Latest News

• 2021-10-01: v2.4 has been released with:
  • fix to retrieve correctly ACME account information
  • fix usage of DNS Host configuration when it is defined with an IP address
  • improvement of code stability by following hints given by pyright
  • Gitlab CI is using ACME server pebble instead of Let's Encrypt staging environment.
  • Gitlab CI validates Debian Bullseye and not any more Debian Jessie
  • Documentation has been moved from the wiki to the git repository
• 2021-06-07: v2.3 has been released with:
  • Feature fixed on v2.3:
    • fix compatibility with dnspython 2.0 ( #11)
    • fix issue when trying to apply DNS update on secondary server (thanks Sebastian Koechlin)
    • fix debug message when CNAME was not found
    • fix test chain assertion (a chain contains more than 1 certificate)
  • Feature added:
    • skip already validated authorization challenge
  • Continuous Integration improvement:
    • Debian Stretch tests were using Debian Jessie image
    • Enable Docker build uses BUILDKIT and the overlay2 filesystem driver
  • Other:
    • the .gitignore file has been simplified

Please see our Gitlab page to find the latest release.

Origin

acme-dns-tiny is a fork of the acme-tiny project, but it has slightly diverged to:

• remove http-01 challenge support
• add dns-01 challenge support by automating the DNS resources update
• support only on python 3
• use a configuration INI file instead of arguments
• use the requests module to send HTTP requests to the ACME server

Code and documentation

Code and documentation are available on Gitlab.
This project is under the MIT license as the original acme-tiny.

A mirror of the code is also available on Github.

You'll find the acme-dns-tiny news on the XMPP community.
To read news from this pubsub link, you can use one instance of the Movim services as the adorsaz.ch Movim pod.
If you want to follow RSS/Atom feed, you can use Movim page too.