linuxshots/godaddy-ddns repository overview

⁠Dynamic DNS with GoDaddy

What is this for?

• Public IP address of some servers or self-hosted server in homelab is dynamic and it changes over time. For e.g. AWS EC2 instance (Without Elastic IP), Home Servers, GCP Cloud, etc.
• This makes it difficult to set DNS for the server and require updating the IP address in GoDaddy DNS record so that requests are forwarded to correct IP address.
• This docker container will automatically update the DNS record with new IP address whenever IP address of server changes.

⁠How to use it

• Pull image

docker pull linuxshots/godaddy-ddns:latest

• Run a container using below command. Replace the values with correct value.

For DNS myserver.example.com with ttl 1200 seconds

docker run --name myserver.example.com -d \
--restart unless-stopped \
--env GD_NAME=myserver --env GD_DOMAIN=example.com --env GD_TTL=1200 \
--env GD_KEY=key-value-from-godaddy-developer-console --env GD_SECRET=secret-key-value-from-godaddy-developer-console \
linuxshots/godaddy-ddns:latest

• Check the log.

docker logs myserver.example.com

• And, You are done.

• Make sure to use --restart option while running docker run. This make sure container starts automatically when your machine boots up.

• To add another dns in same machine (Max 5 recommended due to rate limitations), Run the same docker run command with different container name and other values.

⁠Environment Variables

GD_NAME

This environment variable is required to use this image. This environment variable sets hostname (subdomain). For myserver.example.com myserver is hostname (subdomain).

GD_DOMAIN

This environment variable is required to use this image. This environment variable sets domain name. For myserver.example.com example.com is domain name.

GD_TTL

This environment variable is required to use this image. This environment variable sets time-to-live for a dns record. Minimum value allowed is 600.

GD_KEY

This environment variable is required to use this image. This environment variable sets GoDaddy key to authenticate to GoDaddy APIs. This can be generated from GoDaddy developer console.

GD_SECRET

This environment variable is required to use this image. This environment variable sets GoDaddy secret to authenticate to GoDaddy APIs. This can be generated from GoDaddy developer console.

⁠Contribution guidelines

• You can create issues here --> https://github.com/navilg/godaddy-ddns/issues⁠
• Pull requests are welcomed for review and merge --> https://github.com/navilg/godaddy-ddns/pulls⁠

How to reach me ?

• Author: Navratan Lal Gupta⁠
• You can reach out to me on [email protected]⁠ for any feedback.