You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Ross McFarland 901f36f76e
Minor README fixes
4 months ago
.changelog Minor README fixes 4 months ago
.dependabot Weekly dependabot updates are too noisy, mostly boto 6 years ago
.github/workflows include requirements-dev.txt in changelog install 5 months ago
docs Full doc coverage of the api and related cleanup 4 months ago
octodns more doc related cleanup and infra 4 months ago
script no need to build docs in cibuild 4 months ago
tests Merge branch 'main' into idna-improvements 4 months ago
.ci-config.json Add python 3.13, remove 3.8 1 year ago
.git-blame-ignore-revs add black 24.x to ignore revs 2 years ago
.git_hooks_pre-commit check for changelog entry first 6 months ago
.gitignore Full doc coverage of the api and related cleanup 4 months ago
.readthedocs.yaml docs.txt, not doc 4 months ago
CHANGELOG.md Fix changelog pr urls 4 months ago
CODE_OF_CONDUCT.md Correct CODE_OF_CONDUCT email 9 years ago
CONTRIBUTING.md CONTRIBUTING.md updates, including changelog 7 months ago
LICENSE Update LICENSE details 2 years ago
MANIFEST.in Add missing .md's remove redundant recursives 5 years ago
README.md Minor README fixes 4 months ago
pyproject.toml Move coverage config into pyproject.toml 2 years ago
requirements-dev.txt bump changelet version 4 months ago
requirements-docs.txt mdit-py-plugins early deprecated 3.9 4 months ago
requirements.txt update requirements*.txt 6 months ago
setup.py use the readthedocs theme 4 months ago

README.md

octoDNS Logo

DNS as code - Tools for managing DNS across multiple providers

In the vein of infrastructure as code octoDNS provides a set of tools & patterns that make it easy to manage your DNS records across multiple providers. The resulting config can live in a repository and be deployed just like the rest of your code, maintaining a clear history and using your existing review & workflow.

The architecture is pluggable and the tooling is flexible to make it applicable to a wide variety of use-cases. Effort has been made to make adding new providers as easy as possible. In the simple case that involves writing of a single class and a couple hundred lines of code, most of which is translating between the provider's schema and octoDNS's. More on some of the ways we use it and how to go about extending it below and in the the documentation.

Documentation

For more information on getting started with and using octoDNS, see the documentation.

Contributing

Please see our contributing document if you would like to participate!

Getting help

If you have a problem or suggestion, please open an issue in this repository, and we will do our best to help. Please note that this project adheres to the Contributor Covenant Code of Conduct.

License

octoDNS is licensed under the MIT license.

The MIT license grant is not for GitHub's trademarks, which include the logo designs. GitHub reserves all trademark and copyright rights in and to all GitHub trademarks. GitHub's logos include, for instance, the stylized designs that include "logo" in the file title in the following folder: https://github.com/octodns/octodns/tree/main/docs/logos/

GitHub® and its stylized versions and the Invertocat mark are GitHub's Trademarks or registered Trademarks. When using GitHub's logos, be sure to follow the GitHub logo guidelines.

Authors

octoDNS was designed and authored by Ross McFarland and Joe Williams. See https://github.com/octodns/octodns/graphs/contributors for a complete list of people who've contributed.