hetzner_ddns(1)

NAME
hetzner_ddns - Hetzner Dynamic DNS Daemon

SYNOPSIS
hetzner_ddns [-c config_file] [-l log_file] [-V] [-d] [-h] [-v]

DESCRIPTION
hetzner_ddns Continuously update your servers' A and AAAA records with dynamic IP addresses.

OPTIONS

-c config_file
    Use specified configuration file

-l log_file
    Use specified log file

-P pid_file
    Use specified PID file when daemonized

-V  Display all log messages to stderr

-d  Detach from current shell and run as a daemon

-h  Print help and exit

-v  Print version and exit

CONFIGURATION
The configuration file uses JSON format with the following structure:

  settings

log_file
    Path to a custom configuration file

ip_check_cooldown
    Time between subsequent checks of interface's IP address

request_timeout
    Maximum duration of HTTP requests

api_url
    URL of the Hetzner Console's API

ip_url
    URL of a service for retrieving external IP addresses

  defaults

type
    Default record type (can be "A", "AAAA", or "A/AAAA")

interface
    Default network interface name (auto-detect if unspecified)

ttl Default TTL value in seconds (60 <= TTL <= 2147483647)

  zones
An array of zone objects, each containing:

domain
    Domain name of a zone

records
    An array of record objects, each containing:

    name
        Name of the record (use @ for domain's root)

    type
        Override of the default record type

    ttl Override of the default TTL

    interface
        Override of the default interface

USAGE

Run on startup
    service hetzner_ddns enable

Start
    service hetzner_ddns start

Stop
    service hetzner_ddns stop

Trigger update of all records
    service hetzner_ddns reload