An open API service indexing awesome lists of open source software.

https://github.com/david-lor/docker-duckdns

Docker image to auto-update DuckDNS domains
https://github.com/david-lor/docker-duckdns

ddns docker docker-image dockerfile duckdns

Last synced: 10 months ago
JSON representation

Docker image to auto-update DuckDNS domains

Awesome Lists containing this project

README

          

# Docker-DuckDNS

[![Docker Hub](https://img.shields.io/badge/%20-DockerHub-blue?logo=docker&style=plastic)](https://hub.docker.com/r/davidlor/duckdns)
![Docker Image Size (latest by date)](https://img.shields.io/docker/image-size/davidlor/duckdns?sort=date&style=plastic)

Docker image to update [DuckDNS](https://www.duckdns.org/) dynamic domains,
according to the [HTTP API specifications](https://www.duckdns.org/spec.jsp).

The image will request the DuckDNS HTTPS API endpoint in loop each X minutes,
updating the IP associated with your domain/s with the IP that performed the request.

Main features:

- Based on `alpine:latest`
- Using `curl` as a non-root user
- Token can be provided using Docker Secrets

## Getting started

Supposing your domain is `mydomain.duckdns.org`:

```bash
docker run -d -e DOMAINS=mydomain.duckdns.org -e TOKEN=abcd1234 -e FREQUENCY=10 davidlor/duckdns
```

- **DOMAINS**: comma-separated list of your duckdns.org domains (required)
- **TOKEN**: your personal DuckDNS token (required or provide using Docker Secret)
- **FREQUENCY**: time to wait between requests, in minutes (default: 15)

### Token using Docker Secrets

The Token can be provided using a Docker Secret called `token`.
See the example with [Docker Compose](examples/duckdns-example-secrets).
The Secret token has more priority than the Env token.

## Changelog

- 0.1: Initial release

## TODO

- Multi-arch support