{"id":49551859,"url":"https://github.com/DNSControl/dnscontrol","last_synced_at":"2026-05-06T23:00:51.034Z","repository":{"id":37336462,"uuid":"66963716","full_name":"DNSControl/dnscontrol","owner":"DNSControl","description":"Infrastructure as code for DNS!","archived":false,"fork":false,"pushed_at":"2026-04-13T17:57:25.000Z","size":28802,"stargazers_count":3816,"open_issues_count":71,"forks_count":500,"subscribers_count":56,"default_branch":"main","last_synced_at":"2026-05-01T19:03:26.482Z","etag":null,"topics":["dns","dnscontrol","go","infrastructure-as-code"],"latest_commit_sha":null,"homepage":"https://dnscontrol.org/","language":"Go","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/DNSControl.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2016-08-30T17:42:30.000Z","updated_at":"2026-05-01T16:29:23.000Z","dependencies_parsed_at":"2022-07-12T21:01:20.995Z","dependency_job_id":"36fe1284-bdc2-400e-884f-cf6c970b0da9","html_url":"https://github.com/DNSControl/dnscontrol","commit_stats":{"total_commits":2179,"total_committers":243,"mean_commits":8.96707818930041,"dds":0.5970628728774667,"last_synced_commit":"9dcd8c793ad564101bd541545034faccd62818f5"},"previous_names":[],"tags_count":157,"template":false,"template_full_name":null,"purl":"pkg:github/DNSControl/dnscontrol","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DNSControl%2Fdnscontrol","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DNSControl%2Fdnscontrol/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DNSControl%2Fdnscontrol/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DNSControl%2Fdnscontrol/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DNSControl","download_url":"https://codeload.github.com/DNSControl/dnscontrol/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DNSControl%2Fdnscontrol/sbom","scorecard":{"id":133531,"data":{"date":"2025-08-11","repo":{"name":"github.com/StackExchange/dnscontrol","commit":"e79c43f6eba2659770992a625914939f6d230b91"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":6.8,"checks":[{"name":"Maintained","score":10,"reason":"30 commit(s) and 11 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Code-Review","score":6,"reason":"Found 18/29 approved changesets -- score normalized to 6","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/pr_build.yml:1","Warn: no topLevel permission defined: .github/workflows/pr_check_git_status.yml:1","Warn: no topLevel permission defined: .github/workflows/pr_integration_tests.yml:1","Warn: no topLevel permission defined: .github/workflows/release_draft.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Security-Policy","score":10,"reason":"security policy file detected","details":["Info: security policy file detected: SECURITY.md:1","Info: Found linked content: SECURITY.md:1","Info: Found disclosure, vulnerability, and/or timelines in security policy: SECURITY.md:1","Info: Found text in security policy: SECURITY.md:1"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: MIT License: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pr_build.yml:36: update your workflow using https://app.stepsecurity.io/secureworkflow/StackExchange/dnscontrol/pr_build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pr_build.yml:40: update your workflow using https://app.stepsecurity.io/secureworkflow/StackExchange/dnscontrol/pr_build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pr_build.yml:44: update your workflow using https://app.stepsecurity.io/secureworkflow/StackExchange/dnscontrol/pr_build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pr_build.yml:56: update your workflow using https://app.stepsecurity.io/secureworkflow/StackExchange/dnscontrol/pr_build.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/pr_build.yml:72: update your workflow using https://app.stepsecurity.io/secureworkflow/StackExchange/dnscontrol/pr_build.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/pr_build.yml:81: update your workflow using https://app.stepsecurity.io/secureworkflow/StackExchange/dnscontrol/pr_build.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pr_check_git_status.yml:13: update your workflow using https://app.stepsecurity.io/secureworkflow/StackExchange/dnscontrol/pr_check_git_status.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pr_check_git_status.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/StackExchange/dnscontrol/pr_check_git_status.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/pr_check_git_status.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/StackExchange/dnscontrol/pr_check_git_status.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pr_integration_tests.yml:197: update your workflow using https://app.stepsecurity.io/secureworkflow/StackExchange/dnscontrol/pr_integration_tests.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pr_integration_tests.yml:200: update your workflow using https://app.stepsecurity.io/secureworkflow/StackExchange/dnscontrol/pr_integration_tests.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/pr_integration_tests.yml:214: update your workflow using https://app.stepsecurity.io/secureworkflow/StackExchange/dnscontrol/pr_integration_tests.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release_draft.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/StackExchange/dnscontrol/release_draft.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release_draft.yml:23: update your workflow using https://app.stepsecurity.io/secureworkflow/StackExchange/dnscontrol/release_draft.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release_draft.yml:31: update your workflow using https://app.stepsecurity.io/secureworkflow/StackExchange/dnscontrol/release_draft.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release_draft.yml:37: update your workflow using https://app.stepsecurity.io/secureworkflow/StackExchange/dnscontrol/release_draft.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release_draft.yml:44: update your workflow using https://app.stepsecurity.io/secureworkflow/StackExchange/dnscontrol/release_draft.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/release_draft.yml:57: update your workflow using https://app.stepsecurity.io/secureworkflow/StackExchange/dnscontrol/release_draft.yml/main?enable=pin","Warn: goCommand not pinned by hash: .github/workflows/pr_build.yml:52","Warn: goCommand not pinned by hash: .github/workflows/pr_build.yml:66","Warn: goCommand not pinned by hash: .github/workflows/pr_check_git_status.yml:21","Warn: goCommand not pinned by hash: .github/workflows/pr_integration_tests.yml:207","Warn: goCommand not pinned by hash: .github/workflows/release_draft.yml:51","Info:   0 out of  11 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   7 third-party GitHubAction dependencies pinned","Info:   0 out of   5 goCommand dependencies pinned","Info:   1 out of   1 containerImage dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Branch-Protection","score":-1,"reason":"internal error: error during branchesHandler.setup: internal error: githubv4.Query: Resource not accessible by integration","details":null,"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"SAST","score":-1,"reason":"internal error: internal error: Client.Checks.ListCheckRunsForRef: error during graphqlHandler.setupCheckRuns: Something went wrong while executing your query on 2025-08-12T14:05:33Z. Please include `A7D6:10BC50:576AC1:1165337:689B4A2C` when reporting this issue.","details":null,"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Packaging","score":10,"reason":"packaging workflow detected","details":["Info: Project packages its releases by way of GitHub Actions.: .github/workflows/pr_build.yml:31"],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-16T05:47:21.428Z","repository_id":37336462,"created_at":"2025-08-16T05:47:21.428Z","updated_at":"2025-08-16T05:47:21.428Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32715436,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-06T19:35:05.142Z","status":"ssl_error","status_checked_at":"2026-05-06T19:35:03.996Z","response_time":117,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["dns","dnscontrol","go","infrastructure-as-code"],"created_at":"2026-05-02T23:00:24.636Z","updated_at":"2026-05-06T23:00:51.028Z","avatar_url":"https://github.com/DNSControl.png","language":"Go","funding_links":[],"categories":["Go"],"sub_categories":[],"readme":"# DNSControl\n\n[![DNSControl/dnscontrol/build](https://github.com/DNSControl/dnscontrol/actions/workflows/pr_build.yml/badge.svg)](https://github.com/DNSControl/dnscontrol/actions/workflows/pr_build.yml)\n[![Google Group](https://img.shields.io/badge/google%20group-chat-green.svg)](https://groups.google.com/forum/#!forum/dnscontrol-discuss)\n[![PkgGoDev](https://pkg.go.dev/badge/github.com/DNSControl/dnscontrol)](https://pkg.go.dev/github.com/DNSControl/dnscontrol/v4)\n\n[DNSControl](https://docs.dnscontrol.org/) is a system\nfor maintaining DNS zones.  It has two parts:\na domain specific language (DSL) for describing DNS zones plus\nsoftware that processes the DSL and pushes the resulting zones to\nDNS providers such as Route53, Cloudflare, and Gandi.  It can send\nthe same DNS records to multiple providers.  It even generates\nthe most beautiful BIND zone files ever.  It runs anywhere Go runs (Linux, macOS,\nWindows). The provider model is extensible, so more providers can be added.\n\nCurrently supported DNS providers:\n\n- AdGuard Home\n- Akamai Edge DNS\n- Alibaba Cloud DNS (ALIDNS)\n- AutoDNS\n- AWS Route 53\n- AXFR+DDNS\n- Azure DNS\n- Azure Private DNS\n- BIND\n- Bunny DNS\n- CentralNic Reseller (CNR) - formerly RRPProxy\n- Cloudflare\n- ClouDNS\n- CSC Global (*Experimental*)\n- deSEC\n- DigitalOcean\n- DNS Made Easy\n- DNScale\n- DNSimple\n- Domainnameshop (Domeneshop)\n- Exoscale\n- Fortigate\n- Gandi\n- Gcore\n- Gidinet\n- Google DNS\n- Hetzner\n- hosting.de\n- Huawei Cloud DNS\n- Hurricane Electric DNS\n- Infomaniak\n- INWX\n- Joker\n- Linode\n- Loopia\n- LuaDNS\n- Microsoft Windows Server DNS Server\n- MikroTik RouterOS\n- Mythic Beasts\n- Name.com\n- Namecheap\n- Netcup\n- Netlify\n- NS1\n- Oracle Cloud\n- OVH\n- Packetframe\n- Porkbun\n- PowerDNS\n- Realtime Register\n- RWTH DNS-Admin\n- Sakura Cloud\n- SoftLayer\n- TransIP\n- UniFi Network\n- Vercel\n- Vultr\n\nCurrently supported Domain Registrars:\n\n- AWS Route 53\n- CentralNic Reseller (CNR) - formerly RRPProxy\n- CSC Global\n- DNSimple\n- DNSOVERHTTPS\n- Dynadot\n- easyname\n- Gandi\n- Gidinet\n- hosting.de\n- Internet.bs\n- INWX\n- Loopia\n- Name.com\n- Namecheap\n- OpenSRS\n- OVH\n- Porkbun\n- Realtime Register\n\nStack Overflow uses this system to manage hundreds of domains\nand subdomains across multiple registrars and DNS providers.\n\nYou can think of it as a DNS compiler.  The configuration files are\nwritten in a DSL that looks a lot like JavaScript.  It is compiled\nto an intermediate representation (IR).  Compiler back-ends use the\nIR to update your DNS zones on services such as Route53, Cloudflare,\nand Gandi, or systems such as BIND.\n\n## An Example\n\n`dnsconfig.js`:\n\n```js\n// define our registrar and providers\nvar REG_NAMECOM = NewRegistrar(\"name.com\");\nvar r53 = NewDnsProvider(\"r53\")\n\nD(\"example.com\", REG_NAMECOM, DnsProvider(r53),\n  A(\"@\", \"1.2.3.4\"),\n  CNAME(\"www\",\"@\"),\n  MX(\"@\",5,\"mail.myserver.com.\"),\n  A(\"test\", \"5.6.7.8\")\n)\n```\n\nRunning `dnscontrol preview` will talk to the providers (here name.com as registrar and route 53 as the dns host), and determine what changes need to be made.\n\nRunning `dnscontrol push` will make those changes with the provider and my dns records will be correctly updated.\n\nThe easiest way to run DNSControl is to use the Docker container:\n\n```shell\ndocker run --rm -it -v \"$(pwd):/dns\"  ghcr.io/dnscontrol/dnscontrol preview\n```\n\nSee [Getting Started](https://docs.dnscontrol.org/getting-started/getting-started) page on documentation site to get started!\n\n## Benefits\n\n- **Less error-prone** than editing a BIND zone file.\n- **More reproducible**  than clicking buttons on a web portal.\n- **Easily switch between DNS providers:**  The DNSControl language is\n  vendor-agnostic.  If you use it to maintain your DNS zone records,\n  you can switch between DNS providers easily. In fact, DNSControl\n  will upload your DNS records to multiple providers, which means you\n  can test one while switching to another. We've switched providers 3\n  times in three years and we've never lost a DNS record.\n- **Apply CI/CD principles to DNS!**  StackOverflow maintains their\n  DNSControl configurations in Git and use our CI system to roll out\n  changes.  Keeping DNS information in a VCS means we have full\n  history.  Using CI enables us to include unit-tests and\n  system-tests.  Remember when you forgot to include a \".\" at the end\n  of an MX record?  We haven't had that problem since we included a\n  test to make sure Tom doesn't make that mistake... again.\n- **Adopt (GitOps) PR-based updates.**  Allow developers to send updates as PRs,\n  which you can review before you approve.\n- **Variables save time!**  Assign an IP address to a constant and use the\n  variable name throughout the file. Need to change the IP address\n  globally? Just change the variable and \"recompile.\"\n- **Macros!**  Define your SPF records, MX records, or other repeated data\n  once and re-use them for all domains.\n- **Control Cloudflare from a single source of truth.**  Enable/disable\n  Cloudflare proxying (the \"orange cloud\" button) directly from your\n  DNSControl files.\n- **Keep similar domains in sync** with transforms and other features.  If\n  one domain is supposed to be a filtered version of another, this is\n  easy to set up.\n- **It is extendable!**  All the DNS providers are written as plugins.\n  Writing new plugins is very easy.\n\n## Installation\n\nDNSControl can be installed via packages for macOS, Linux and Windows, or from source code. See the [official instructions](https://docs.dnscontrol.org/getting-started/getting-started#1-install-the-software).\n\n## Via GitHub Actions (GHA)\n\nSee [dnscontrol-action](https://github.com/koenrh/dnscontrol-action) or [gacts/install-dnscontrol](https://github.com/gacts/install-dnscontrol).\n\n## Deprecation warnings (updated 2025-11-21)\n\n- **REV() will switch from RFC2317 to RFC4183 in v5.0.**  This is a breaking change. Warnings are output if your configuration is affected. No date has been announced for v5.0. See https://docs.dnscontrol.org/language-reference/top-level-functions/revcompat\n- **NAMEDOTCOM, OPENSRS, and SOFTLAYER need maintainers!** These providers have no maintainer. Maintainers respond to PRs and fix bugs in a timely manner, and try to stay on top of protocol changes. Interested in being a hero and adopting them?  Contact tal at what exit dot org.\n\n## More info at our website\n\nThe website: [https://docs.dnscontrol.org/](https://docs.dnscontrol.org/)\n\nThe getting started guide: [https://docs.dnscontrol.org/getting-started/getting-started](https://docs.dnscontrol.org/getting-started/getting-started)\n\n## Stargazers over time\n\n[![Stargazers over time](https://starchart.cc/DNSControl/dnscontrol.svg?variant=adaptive)](https://starchart.cc/DNSControl/dnscontrol)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDNSControl%2Fdnscontrol","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FDNSControl%2Fdnscontrol","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDNSControl%2Fdnscontrol/lists"}