porkbun-ddns

This project updates your DNS records at Porkbun with your current public IP address. Your IP address is determined using https://wtfismyip.com/

Install

Snapcraft

• Run snap install porkbun-ddns
• Place your configuration at /var/snap/porkbun-ddns/common/config.yaml
• An example configuration can be found at https://raw.githubusercontent.com/jadolg/porkbun-ddns/main/example.config.yaml
• Restart the service snap restart porkbun-ddns.porkbun-ddns-daemon

Docker

Modify the following command to match your specific requirements (path to the config file):

docker run -d --restart always --network host -v $PWD/config.yaml:/config.yaml ghcr.io/jadolg/porkbun-ddns:latest

note: I'm using --network host to avoid setting up IPv6 in Docker.

Direct download

Not a fan of running snaps or docker? Not a problem! Grab the binary for your system/architecture directly from the release page and start using it.

From source

You can also just install from GitHub using Go directly go install github.com/jadolg/porkbun-ddns@latest

Metrics

To enable the collection of metrics, change the config file and set a valid port. The current metrics are:

• porkbun_update_errors_total
• porkbun_credentials_errors_total
• porkbun_connection_errors_total
• porkbun_resolve_errors_total
• porkbun_update_success_total