{"id":20572591,"url":"https://github.com/ffddorf/knot-resolver","last_synced_at":"2026-04-21T09:31:35.416Z","repository":{"id":38182872,"uuid":"256255511","full_name":"ffddorf/knot-resolver","owner":"ffddorf","description":":construction: WIP: Ansible role for a DNS resolver using software from the Knot project","archived":false,"fork":false,"pushed_at":"2023-12-15T05:55:46.000Z","size":37,"stargazers_count":1,"open_issues_count":7,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-06T10:23:38.942Z","etag":null,"topics":["ansible","dns","docker","knot","molecule"],"latest_commit_sha":null,"homepage":null,"language":"Jinja","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/ffddorf.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":"2020-04-16T15:29:28.000Z","updated_at":"2022-01-27T09:45:14.000Z","dependencies_parsed_at":"2024-11-16T05:33:09.616Z","dependency_job_id":null,"html_url":"https://github.com/ffddorf/knot-resolver","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ffddorf/knot-resolver","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ffddorf%2Fknot-resolver","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ffddorf%2Fknot-resolver/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ffddorf%2Fknot-resolver/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ffddorf%2Fknot-resolver/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ffddorf","download_url":"https://codeload.github.com/ffddorf/knot-resolver/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ffddorf%2Fknot-resolver/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32085409,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-21T06:27:27.065Z","status":"ssl_error","status_checked_at":"2026-04-21T06:27:21.250Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["ansible","dns","docker","knot","molecule"],"created_at":"2024-11-16T05:22:02.523Z","updated_at":"2026-04-21T09:31:34.428Z","avatar_url":"https://github.com/ffddorf.png","language":"Jinja","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Knot Resolver with Ansible\n\nAn Ansible role that installs a Knot Resolver service.\n\nThis code is for training purposes and not production ready.\n\n## Description\n\nWe use the Ansible config management system to automate installation of a service.\n\nConfiguration is done by a template, which includes the primary IP addresses of the target system.\n\nThe whole process is automatically tested by Molecule. It runs on Docker to make tests quick.\n\nThe complicated part is where we run systemd inside a container to test the service supervisor.\n\n## Preparation\n\nWe need to build a custom Docker image first. Inside the `role/knot-resolver/molecule` directory run the following:\n\n```\ndocker build -t debian-systemd:10 .\n```\n\n## Usage\n\nThe whole building and testing process is automated in a single command. Go to the `role/knot-resolver` directory and run:\n\n```\nmolecule test\n```\n\n## Development\n\nChange the Ansible files freely and have Molecule apply them again with the following command:\n\n```\nmolecule converge\n```\n\n## Role Variables\n\n`kresd_instances` the number of service instances to start (default: 2)\n`kresd_cachesize` size of the persisent resolver cache in MB (default: 100)\n`kresd_prefix_ip4` restrict access to this IPv4 prefix (default: none)\n`kresd_prefix_ip6` restrict access to this IPv6 prefix (default: none)\n\n## Example Playbook\n\n```\n- hosts: dns-resolvers\n  roles:\n    - role: knot-resolver\n      vars:\n        kresd_instances: 3\n        kresd_cachesize: 200\n        kresd_prefix_ip4: 192.168.0.0/16\n        kresd_prefix_ip4: fd00:1::/64\n```\n\n## License\n\nMIT License\n\n## Author Information\n\nFreifunk Düsseldorf e.V. \u003ckontakt@freifunk-duesseldorf.de\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fffddorf%2Fknot-resolver","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fffddorf%2Fknot-resolver","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fffddorf%2Fknot-resolver/lists"}