Skip to content

pascaliske/docker-digitalocean-dyndns

Repository files navigation

Simple container image to update a dynamic DNS record using the DigitalOcean API.

Docker Image Version (tag latest semver) Docker Image Size (tag) Docker Pulls GitHub Tag Build Status GitHub Last Commit License: MIT Awesome Badges

Image

Registry Image
Docker Hub pascaliske/digitalocean-dyndns
GitHub ghcr.io/pascaliske/digitalocean-dyndns

The following platforms are available for this image:

$ docker run --rm mplatform/mquery pascaliske/digitalocean-dyndns:latest
Image: pascaliske/digitalocean-dyndns:latest
 * Manifest List: Yes
 * Supported platforms:
   - linux/amd64
   - linux/arm/v7
   - linux/arm64

Usage

To use this image pull it from one of the following registries:

# docker hub
docker pull pascaliske/digitalocean-dyndns

# github container registry
docker pull ghcr.io/pascaliske/digitalocean-dyndns

Then run it using the following command:

# docker hub
docker run --rm -e DOMAIN=domain.com -e NAME=my pascaliske/digitalocean-dyndns

# github container registry
docker run --rm -e DOMAIN=domain.com -e NAME=my ghcr.io/pascaliske/digitalocean-dyndns

This will update the subdomain record my.domain.com in the DNS zone domain.com with your current IP address.

Configuration

You can configure the container with the following additional environment variables:

Variable Required Default Description
TZ No UTC Adjust the time zone inside the container
IP_SERVICE No ifconfig.co The IP service to retrieve your public IP address
DOMAIN Yes - Your domain within the DigitalOcean control panel
NAME Yes - Your subdomain record to update
DO_TOKEN Yes - Your DigitalOcean API token

Kubernetes

If you want to use this tool as an CronJob inside of a Kubernetes cluster check out my ready to deploy Helm chart!

License

MIT – © 2022 Pascal Iske