Simple Dynamic DNS Web management self-hosting. It use dnsmasq. It was inspired on duckdns.org.
You need root access to a server, virtual machine or container. The 53 port must be open in your firewall.
Also, you have to create these records in your Zone DNS of your domain provider:
- (required) A record for subdomain (myddns.example.com) to point to IPv4 of your server
- (optional) AAAA record for subdomain (myddns.example.com) to point to IPv6 of your server
- (required) NS record to point to subdomain (myddns.example.com)
- Install docker and docker-composer.
- Disable systemd-resolved or any other service that use 53 port.
- Clone this repository.
- Copy .env.example to .env and set the environment variables.
- Execute:
docker-compose up -d --build- Change to root user
- Clone this repository
- Run INSTALL.bash as root
This script will ask you for the BASEDOMAIN, BASEIP and PASSWORD values interactively. They can also be read as environment variables.
Open base domain in your browser and click on "Update" button.
You can use curl or wget and call it from a cron to automatize:
curl -s "http://myddns.example.com/?action=1&format=json&subdomain=<SUBDOMAIN>&code=<PASSWORD>"They can be sent both by POST and by GET:
- action: To create or update must be 1. By default is 0.
- format: 'html', 'json' or 'simple'. By default is 'html'.
- subdomain: It can only contain lowercase letters, numbers, or the symbols '_' and '-'. At least 4 characters. By default is ''.
- ip: It can only contain a valid IP. By default, it autodetects the IP from which the request is made.
- code: The password defined in config.php file. If empty, you can manage myDDNS without password required.
- domain
- ip
- error: false if the ip to subdomain was updated, true if not.
- errormsg: object with error messages if any.
- OK if the ip to subdomain was updated.
- KO if the ip to subdomain was not updated.