Skip to main content

ddns-updater

Use these steps to run ddns-updater with Docker Compose.

Create the Data Directory​

Create the data directory and set the required permissions:

mkdir data
chown 1000 data
chmod u+r+w+x data

Create the Config File​

Create the ddns-updater config file and set read permissions:

touch data/config.json
chmod u+r data/config.json

Open data/config.json:

vim data/config.json

Use this configuration as a starting point:

{
  "settings": [
    {
      "provider": "namecheap",
      "domain": "sub.example.com",
      "password": "replace-with-your-namecheap-ddns-password"
    }
  ]
}

Create the Compose File​

Create a docker-compose.yml file with the ddns-updater service:

services:
  ddns-updater:
    image: ghcr.io/qdm12/ddns-updater
    container_name: ddns-updater
    restart: unless-stopped
    ports:
      - "8000:8000/tcp"
    volumes:
      - ./data:/updater/data

Start ddns-updater​

Run Docker Compose from the directory containing docker-compose.yml:

docker compose up -d

ddns-updater will be available at http://localhost:8000.

Reverse Proxy / HTTPS​

If you need HTTPS access to the ddns-updater web UI, put it behind a reverse proxy like Nginx Proxy Manager.