ApertoDNS Docker Images

Official Docker images for ApertoDNS - Free Dynamic DNS Service.

Available Images

Image	Description	Size	Architectures
apertodns/updater	Lightweight DDNS daemon	~15MB	amd64, arm64, arm/v7
apertodns/cli	CLI tool container	~150MB	amd64, arm64

Quick Start

Updater (DDNS Daemon)

Keep your DNS records automatically updated:

docker run -d \
  --name apertodns-updater \
  --restart unless-stopped \
  -e TOKEN=your_token_here \
  -e DOMAINS=myhost.apertodns.com \
  apertodns/updater:latest

CLI Tool

Run CLI commands without installing Node.js:

# Show help
docker run --rm apertodns/cli --help

# Interactive setup
docker run --rm -it -v apertodns_config:/root/.config/apertodns apertodns/cli --setup

# List domains
docker run --rm -v apertodns_config:/root/.config/apertodns apertodns/cli --domains

# Standalone update (no config required)
docker run --rm apertodns/cli --update --domain myhost.apertodns.com --token YOUR_TOKEN

# TXT record for ACME DNS-01 (Let's Encrypt)
docker run --rm -e APERTODNS_API_KEY="your-key" apertodns/cli --txt-set myhost.apertodns.com _acme-challenge "token"

Documentation

• Updater Documentation - Full guide for the DDNS daemon
• CLI Documentation - Full guide for the CLI container
• ApertoDNS Docs - Main documentation

Getting Your Token

1. Register at apertodns.com
2. Create a domain in the dashboard
3. Copy the token from Domain Settings

Registry Mirrors

Images are available from both Docker Hub and GitHub Container Registry:

# Docker Hub
docker pull apertodns/updater:latest
docker pull apertodns/cli:latest

# GitHub Container Registry
docker pull ghcr.io/apertodns/apertodns-updater:latest
docker pull ghcr.io/apertodns/apertodns-cli:latest

Platform Support

Updater

• Raspberry Pi (all models) - arm/v7, arm64
• Linux servers - amd64
• NAS devices - Synology, QNAP
• Cloud instances - AWS, GCP, Azure

CLI

• Linux - amd64, arm64
• macOS - via Rosetta 2 (arm64)
• Windows - via WSL2 (amd64)

Links

• Website: apertodns.com
• Dashboard: apertodns.com/dashboard
• CLI on npm: npmjs.com/package/apertodns
• CLI on GitHub: github.com/apertodns/apertodns

Support

• Issues: GitHub Issues
• Email: support@apertodns.com

License

MIT - Aperto Network