🐷 Porkbun DDNS
Updates one existing Porkbun A record to the host's public IPv4 address.
🛠 Usage
Enable API access for your domain and store your credentials in a protected JSON file outside this repository:
{
"apikey": "YOUR_API_KEY",
"secretapikey": "YOUR_SECRET_API_KEY"
}
Mount the file read-only to update home.example.com:
docker run --rm \
--user "$(id -u):$(id -g)" \
--mount type=bind,src=/path/to/porkbun.json,dst=/run/secrets/porkbun.json,readonly \
ghcr.io/eleith/containers-porkbun-ddns example.com home
Arguments
| Argument | Description |
|---|---|
--dry-run |
Optional; place before the domain to report changes without updating DNS. Still calls Porkbun to check the IP and record. |
domain |
Porkbun zone, such as example.com or example.co.uk. |
name |
Relative record name, such as home or services.home; use "" for the zone apex. |
--user |
lets the container read a credentials file protected for your host user. Without it, the image runs as UID/GID 65534:65534 |
Requires exactly one existing A record;
✅ Tests
Local checks use mocked HTTP calls
shellcheck porkbun-ddns/update.sh porkbun-ddns/tests/update_test.sh
bash porkbun-ddns/tests/update_test.sh
📦 Tech Stack
- Base: Alpine Linux
- Tools: Bash, curl, jq