aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README.md35
1 files changed, 33 insertions, 2 deletions
diff --git a/README.md b/README.md
index 8755586..6c490f5 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,36 @@
# octodns-custom-providers
-* octodns-custom-providers.provider.zonefile.ZoneFileProvider
-* octodns-custom-providers.source.phpipam.PhpipamSource
+Custom [OctoDNS](https://github.com/octodns/octodns) Providers/Sources I wrote for myself
+
+## octodns-custom-providers.provider.zonefile.ZoneFileProvider
+
+OctoDNS only provides a ZoneFile source. This Provider can create a BIND compatible ZoneFile.
+It can NOT be used as a source. Use the builtin OctoDNS ZoneFile source instead.
+
+Example
+
+```
+providers:
+ zonefile:
+ class: octodns-custom-providers.provider.zonefile.ZoneFileProvider
+ directory: zonefiles
+```
+
+## octodns-custom-providers.source.phpipam.PhpipamSource
+
+This source allows to use [PHPipam](https://github.com/phpipam/phpipam) as a source for IP address mappings.
+
+Requires: [python-phpipam](https://github.com/kompetenzbolzen/python-phpipam)
+
+```
+roviders:
+ phpipam:
+ class: octodns-custom-providers.source.phpipam.PhpipamSource
+ url: 'https://phpipam.example.com/'
+ user: env/PHPIPAM_USER
+ token: env/PHPIPAM_TOKEN
+ appid: 'myapp'
+ cidrs:
+ - 10.1.0.0/16
+```