{"id":16683812,"url":"https://github.com/jitsusama/lets-do-dns","last_synced_at":"2025-10-07T04:13:36.318Z","repository":{"id":57438612,"uuid":"89433363","full_name":"Jitsusama/lets-do-dns","owner":"Jitsusama","description":"A letsencrypt certbot auth/cleanup hook program engineered to handle hostname ownership authentication via DigitalOcean's DNS system.","archived":false,"fork":false,"pushed_at":"2019-10-02T15:07:28.000Z","size":389,"stargazers_count":8,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-07-13T13:28:45.005Z","etag":null,"topics":["authentication","certbot","certificates","digitalocean","dns","letsencrypt","ssl"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Jitsusama.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}},"created_at":"2017-04-26T03:24:48.000Z","updated_at":"2018-07-02T23:35:16.000Z","dependencies_parsed_at":"2022-09-08T07:10:24.327Z","dependency_job_id":null,"html_url":"https://github.com/Jitsusama/lets-do-dns","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/Jitsusama/lets-do-dns","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jitsusama%2Flets-do-dns","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jitsusama%2Flets-do-dns/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jitsusama%2Flets-do-dns/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jitsusama%2Flets-do-dns/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jitsusama","download_url":"https://codeload.github.com/Jitsusama/lets-do-dns/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jitsusama%2Flets-do-dns/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265508349,"owners_count":23779129,"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":["authentication","certbot","certificates","digitalocean","dns","letsencrypt","ssl"],"created_at":"2024-10-12T14:26:19.073Z","updated_at":"2025-10-07T04:13:31.268Z","avatar_url":"https://github.com/Jitsusama.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"lets-do-dns\n-----------\nThis program's purpose is to function as a manual authentication and\ncleanup hook for the Let's Encrypt [EFF's][1] [certbot][2] client program\nwhen you wish to use [ACME-DNS][3] authentication during the certificate\nauthentication process, while also using [DigitalOcean's][4] DNS\ninfrastructure for the creation and removal of the ACME-DNS required DNS\nTXT records. This program also supports being passed a command string that\nwill be called during the cleanup hook stage of the authentication process.\n\nInstallation\n============\nInstallation of this program is quite easy, as it only has one external\ndependency, and this program includes this dependency in its setup.py\nfile.\n\nThat said, there are 4 ways that you can install this program;\n\n*  The first is via the normal means, that is, PyPI via PIP as so:\n\n   `pip install lets-do-dns`\n\n*  You can also install this program from a clone of the source\n   repository, as so (remember, if you want to modify the source code\n   without re-installing, pass the `-e` flag to PIP):\n\n   `pip install .`\n\n*  You can also use Docker to install/run this program. You can do this\n   like so when grabbing from the Docker Hub:\n\n   `docker pull jitsusama/lets-do-dns`\n\n*  Finally, you can build the image from a clone of the source\n   repository like so:\n\n   `docker build -t jitsusama/lets-do-dns .`\n\nUsage\n=====\nMake sure you pass the `DO_APIKEY` and `DO_DOMAIN` environment\nvariables to certbot when it is called. Tell certbot to load this program\nby passing its name to certbot via the `--manual-auth-hook` and the\n`--manual-cleanup-hook` CLI arguments.\n\nIf you would also like for this program to call your own program during\nthe cleanup hook stage, make sure you pass the `LETS_DO_POSTCMD`\nenvironment variable to certbot as well, specifying the invocation string\nof your program.\n\nHere's an example of how you can use this program from the CLI when\nyou installed the program via PIP:\n\n```bash\nDO_APIKEY=super-secret-key \\\nDO_DOMAIN=mydomain.com \\\nLETS_DO_POSTCMD='echo ${CERTBOT_DOMAIN} \u003e command_output.txt' \\\ncertbot certonly --manual -d myhostname.mydomain.com \\\n    --preferred-challenges dns \\\n    --manual-auth-hook lets-do-dns \\\n    --manual-cleanup-hook lets-do-dns\n```\n\nHere's an example of how you can use this program from Docker when\nyou pulled the image from the Docker Hub:\n\n```bash\ndocker run -v \"$(pwd)/my-cert-dir:/etc/letsencrypt\" \\\n    -e \"DO_APIKEY=super-secret-key\" \\\n    -e \"DO_DOMAIN=mydomain.com\" \\\n    -e 'LETS_DO_POSTCMD=\"echo ${CERTBOT_DOMAIN} \u003e /etc/letsencrypt/command_output.txt\"' \\\n    jitsusama/lets-do-dns \\\n    certonly --manual -d myhostname.mydomain.com \\\n        --preferred-challenges dns \\\n        --manual-auth-hook lets-do-dns \\\n        --manual-cleanup-hook lets-do-dns\n```\n\n[1]: https://eff.org\n[2]: https://certbot.eff.org\n[3]: https://tools.ietf.org/html/draft-ietf-acme-acme-06#section-8.4\n[4]: https://digitalocean.com\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjitsusama%2Flets-do-dns","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjitsusama%2Flets-do-dns","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjitsusama%2Flets-do-dns/lists"}