# DDNS

DDNS is a personal dynamic DNS client that automatically updates DigitalOcean DNS records with your current IP address. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2751/ddns

## Description

DDNS is a personal dynamic DNS client that automatically updates DigitalOcean DNS records with your current IP address. It gives homelab users a self-hosted way to keep domain names pointing to changing addresses without paid third-party dynamic DNS services. Configure hostnames and credentials in .ddns.yml.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

65/100 (Good), based on 5 of 5 factors.
- Maintained: 72 (last commit 28 days ago)
- Popular: 49 (268 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 100 (32 MB minimum RAM)
- Security check: 74 (no serious findings, CI, tests, OpenSSF Scorecard 3.4/10)

## Links

- Unraid: https://ca.unraid.net/apps/ddns-18no2zm0w51yue?q=ddns

## Common questions

### Where does skibish/ddns look for its config if I do not pass a file path?

It searches the current directory first and then the user's HOME directory for a ddns.yml file. You can override this with the -conf-file flag.

### How do I provide the DigitalOcean API token to the app?

Put the token in the token field of ddns.yml or set the DDNS_TOKEN environment variable.

### What DigitalOcean setup is required before the client can update DNS?

You must add your domain in the DigitalOcean Networks panel and point your domain name provider's nameservers to DigitalOcean.

### Can skibish/ddns update IPv6 addresses?

IPv6 is not requested by default. Set ipv6 to true in the configuration or use the DDNS_IPV6 environment variable to force it.

### How can I change how often the client checks the public IP?

Set checkPeriod in ddns.yml, with a default of 5 minutes. It can also be set with the DDNS_CHECKPERIOD environment variable.

### How should I run the Docker image with my own configuration?

Mount your ddns.yml into the container at /config/ddns.yml and start the image with -conf-file /config/ddns.yml.

---
Source: Our Local Host (https://ourlocalhost.com/app/2751/ddns), the self-hosted and open-source app directory.
