netbox-ddns/README.md

34 lines
1.5 KiB
Markdown
Raw Normal View History

2020-04-15 01:09:13 +02:00
# Dynamic DNS Connector for NetBox
2020-04-15 00:56:20 +02:00
2020-04-15 15:42:15 +02:00
This plugin lets you define DNS servers that support [RFC3007 Dynamic DNS Updates](https://tools.ietf.org/html/rfc3007).
For each server you specify which domains and reverse DNS domains it is responsible for, and after that NetBox will
automatically send DNS Updates to those servers whenever you change the DNS name of an IP Address in NetBox.
2020-04-15 01:09:13 +02:00
2020-04-15 15:42:15 +02:00
Updates are sent from the worker process in the background. You can see their progress either by configuring Django
logging or by looking at the Background Tasks in the NetBox admin back-end.
2020-04-15 01:09:13 +02:00
For now all configuration is done in the NetBox admin back-end. A later version will provide a nicer user interface.
2020-04-15 00:56:20 +02:00
## Compatibility
2020-12-26 19:52:03 +01:00
This plugin in compatible with [NetBox](https://netbox.readthedocs.org/) 2.8, 2.9 and 2.10.
NetBox 2.10 introduced breaking changes that make it unusable for my own use cases. There is work being done to create
a fork of NetBox that is friendlier to both network operators and contributors. My future work will be in support of
that.
2020-04-15 15:42:15 +02:00
## Installation
First, add `netbox-ddns` to your `/opt/netbox/local_requirements.txt` file. Create it if it doesn't exist.
Then enable the plugin in `/opt/netbox/netbox/netbox/configuration.py`, like:
```python
PLUGINS = [
'netbox_ddns',
]
```
And finally run `/opt/netbox/upgrade.sh`. This will download and install the plugin and update the database when
necessary. Don't forget to run `sudo systemctl restart netbox netbox-rq` like `upgrade.sh` tells you!