{"id":14378851,"url":"https://github.com/alexzorin/certbot-dns-multi","last_synced_at":"2025-04-05T09:05:41.521Z","repository":{"id":61320168,"uuid":"550132406","full_name":"alexzorin/certbot-dns-multi","owner":"alexzorin","description":"Certbot DNS plugin supporting multiple providers, using github.com/go-acme/lego","archived":false,"fork":false,"pushed_at":"2025-02-18T21:31:48.000Z","size":212,"stargazers_count":58,"open_issues_count":5,"forks_count":7,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-29T08:05:24.402Z","etag":null,"topics":["acme","certbot","certbot-dns","certbot-plugin"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alexzorin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-12T08:56:01.000Z","updated_at":"2025-03-28T14:07:50.000Z","dependencies_parsed_at":"2024-03-22T23:22:23.387Z","dependency_job_id":"afcf9719-fa12-4fe6-822e-22cd70d531da","html_url":"https://github.com/alexzorin/certbot-dns-multi","commit_stats":null,"previous_names":[],"tags_count":35,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexzorin%2Fcertbot-dns-multi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexzorin%2Fcertbot-dns-multi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexzorin%2Fcertbot-dns-multi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alexzorin%2Fcertbot-dns-multi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alexzorin","download_url":"https://codeload.github.com/alexzorin/certbot-dns-multi/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247312077,"owners_count":20918344,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["acme","certbot","certbot-dns","certbot-plugin"],"created_at":"2024-08-28T11:01:03.783Z","updated_at":"2025-04-05T09:05:41.485Z","avatar_url":"https://github.com/alexzorin.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"# certbot-dns-multi\n\n[![certbot-dns-multi](https://snapcraft.io/certbot-dns-multi/badge.svg)](https://snapcraft.io/certbot-dns-multi) ![build status](https://github.com/alexzorin/certbot-dns-multi/actions/workflows/build-and-publish.yml/badge.svg)  ![snap test status](https://github.com/alexzorin/certbot-dns-multi/actions/workflows/test-snap.yml/badge.svg)\n\nDNS plugin for [Certbot](https://certbot.eff.org/) which integrates with the 117+ DNS providers from the [`lego` ACME client](https://github.com/go-acme/lego/).\n\nAt the last check, the supported providers are:\n\n\u003e Akamai EdgeDNS, Alibaba Cloud DNS, all-inkl, Amazon Lightsail, Amazon Route 53, ArvanCloud, Aurora DNS, Autodns, Azure (deprecated), Azure DNS, Bindman, Bluecat, Brandit, Bunny, Checkdomain, Civo, Cloud.ru, CloudDNS, Cloudflare, ClouDNS, CloudXNS, ConoHa, Constellix, CPanel/WHM, Derak Cloud, deSEC.io, Designate DNSaaS for Openstack, Digital Ocean, DNS Made Easy, dnsHome.de, DNSimple, DNSPod (deprecated), Domain Offensive (do.de), Domeneshop, DreamHost, Duck DNS, Dyn, Dynu, EasyDNS, Efficient IP, Epik, Exoscale, External program, freemyip.com, G-Core, Gandi Live DNS (v5), Gandi, Glesys, Go Daddy, Google Cloud, Google Domains, Hetzner, Hosting.de, Hosttech, HTTP request, http.net, Hurricane Electric DNS, HyperOne, IBM Cloud (SoftLayer), IIJ DNS Platform Service, Infoblox, Infomaniak, Internet Initiative Japan, Internet.bs, INWX, Ionos, IPv64, iwantmyname, Joker, Joohoi's ACME-DNS, Liara, Linode (v4), Liquid Web, Loopia, LuaDNS, Mail-in-a-Box, Manual, Metaname, MyDNS.jp, MythicBeasts, Name.com, Namecheap, Namesilo, NearlyFreeSpeech.NET, Netcup, Netlify, Nicmanager, NIFCloud, Njalla, Nodion, NS1, Open Telekom Cloud, Oracle Cloud, OVH, plesk.com, Porkbun, PowerDNS, Rackspace, RcodeZero, reg.ru, RFC2136, RimuHosting, Sakura Cloud, Scaleway, Selectel, Servercow, Shellrent, Simply.com, Sonic, Stackpath, Tencent Cloud DNS, TransIP, UKFast SafeDNS, Ultradns, Variomedia, VegaDNS, Vercel, Versio.\\[nl/eu/uk\\], VinylDNS, VK Cloud, Vscale, Vultr, Webnames, Websupport, WEDOS, Yandex 360, Yandex Cloud, Yandex PDD, Zone.ee, Zonomi\n\n## Installation\n\n### via `snap`\n\nUsing the `certbot` snap is the easiest way to use this plugin. See [here](https://certbot.eff.org/instructions?ws=other\u0026os=snap) for instructions on installing Certbot via `snap`.\n\n```bash\nsudo snap install certbot-dns-multi\nsudo snap set certbot trust-plugin-with-root=ok\nsudo snap connect certbot:plugin certbot-dns-multi\n```\n\n### via `pip`\n\nCompiled wheels [are available](https://pypi.org/project/certbot-dns-multi/#files) for most `x86_64`/`amd64` Linux distributions. On other platforms, `pip` will try to compile the plugin, which requires [Go 1.19 or newer](https://go.dev/dl) to be installed on your server.\n\n| How did you install Certbot?                                                                          | How to install the plugin                             |\n|-------------------------------------------------------------------------------------------------------|-------------------------------------------------------|\n| From `snap`                                                                                           | Don't use `pip`! Use the snap instructions above.     |\n| Using the [official Certbot `pip` instructions](https://certbot.eff.org/instructions?ws=other\u0026os=pip) | `sudo /opt/certbot/bin/pip install certbot-dns-multi` |\n| From `apt`, `yum`, `dnf` or any other distro package manager. (Requires Certbot 1.12.0 or newer.)     | `pip install certbot-dns-multi`                       |\n\n### via `docker`\n\nDocker images for `linux/amd64` and `linux/arm64` are available from [`ghcr.io/alexzorin/certbot-dns-multi`](https://ghcr.io/alexzorin/certbot-dns-multi).\n\ne.g.\n\n```bash\ndocker run --rm -it -v /etc/letsencrypt:/etc/letsencrypt \\\nghcr.io/alexzorin/certbot-dns-multi certonly \\\n-a dns-multi --dns-multi-credentials /etc/letsencrypt/dns-multi.ini \\\n-d \"*.example.com\" -d \"example.com\" --dry-run\n```\n\n## Usage\n\n`certbot-dns-multi` is controlled via a credentials file.\n\n1. Head to https://go-acme.github.io/lego/dns/ and find your DNS provider in the list.\nIn this example, we'll use `cloudflare`.\n2. Create `/etc/letsencrypt/dns-multi.ini` and enter the name of your provider, all lowercase, as below:\n\n    ```ini\n    dns_multi_provider = cloudflare\n    ```\n\n3. Following the instructions on https://go-acme.github.io/lego/dns/cloudflare/, we add the required configuration items:\n\n    ```ini\n    dns_multi_provider = cloudflare\n    CLOUDFLARE_DNS_API_TOKEN=\"1234567890abcdefghijklmnopqrstuvwxyz\"\n    ```\n\n4. Save the file and secure it:\n\n    ```bash\n    chmod 0600 /etc/letsencrypt/dns-multi.ini\n    ```\n\n5. Try issue a certificate now:\n\n    ```bash\n    certbot certonly -a dns-multi \\\n    --dns-multi-credentials=/etc/letsencrypt/dns-multi.ini \\\n    -d \"*.example.com\" \\\n    --dry-run\n    ```\n\n6. 🥳, or if not, ask on [the community forums](https://community.letsencrypt.org/) for help.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexzorin%2Fcertbot-dns-multi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falexzorin%2Fcertbot-dns-multi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falexzorin%2Fcertbot-dns-multi/lists"}