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

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

Install Namecheap-DDNS-Updater on Unraid in a few clicks.

Find Namecheap-DDNS-Updater in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.

Open the Apps tab on your Unraid server Search Community Apps for Namecheap-DDNS-Updater Review the template variables and paths Click Install

Download Statistics

1,134
Total Downloads

Details

Repository
tranceer/namecheap-ddns-updater:latest
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