Namecheap-DDNS-Updater

Namecheap-DDNS-Updater

Docker app from Selfhosters

Overview

This container automatically updates your Namecheap Dynamic DNS records for multiple hosts at a specified interval. At startup, the container generates a script located at /app/entrypoint.sh. You can manually edit this script inside the container for advanced customization. Before using this container: - Make sure you have an A record for @.yourdomain.com - Add CNAME records for each subdomain (e.g., admin.yourdomain.com) - Enable Dynamic DNS in your Namecheap dashboard and copy the API key Based on this tutorial: https://www.youtube.com/watch?v=9Wd2a_69QlW Original script by Daniel Boctor: https://github.com/daniel-boctor

Readme

View on GitHub

Namecheap DDNS Updater

Docker Pulls Docker Image Size

Automatically updates your Namecheap Dynamic DNS records for multiple hosts at a specified interval.

📦 Features

  • Easy to configure
  • Lightweight container
  • Supports multiple hosts
  • Simple logging output
  • Fully customizable entrypoint.sh script inside the container

🛠️ Usage

You can deploy this container easily via Unraid Community Applications.

Environment Variables:

Variable Description
DOMAIN Your domain name (e.g., yourdomain.com)
API_KEY Your Namecheap Dynamic DNS API key
HOSTS Comma-separated list of hosts to update (e.g., @,www,admin)
INTERVAL How often to update the DNS records, in seconds (e.g., 600)

🖥️ Setup Example

docker run -d \
  --name=namecheap-ddns-updater \
  -e DOMAIN=yourdomain.com \
  -e API_KEY=your_api_key \
  -e HOSTS=@,www,admin \
  -e INTERVAL=600 \
  tranceer/namecheap-ddns-updater:latest

Download Statistics

1,277
Total Downloads

Links

Projectgithub.comSupportgithub.comDocker Hubhub.docker.comTemplateraw.githubusercontent.com

Details

Repository
tranceer/namecheap-ddns-updater:latest
Registry
https://hub.docker.com/r/tranceer/namecheap-ddns-updater
Last Updated2025-05-06
First Seen2025-05-05

Runtime arguments

Network
bridge
Shell
bash
Privileged
false

Template configuration

DomainVariable

The domain name you want to update

Target
DOMAIN
Default
yourdomain.com
Value
yourdomain.com
API KeyVariable

Your Namecheap Dynamic DNS password (API Key)

Target
API_KEY
HostsVariable

A comma-separated list of hosts to update

Target
HOSTS
Default
@
Value
@
IntervalVariable

How often, in seconds, to update your hosts

Target
INTERVAL
Default
600
Value
600