Porkbun Client support

A Porkbun account with at least one domain, and a Porkbun API key pair. You'll also need to turn on API access for each domain you want to manage.

1. Sign in at porkbun.com and go to Account → API Access.
2. Create a new key. You'll get an API key (starting pk1_) and a secret key (starting sk1_). Copy both; the secret is only shown once.
3. Paste both into the app's first screen and tap Connect. The app checks them with Porkbun before saving them.

Porkbun needs API access turned on for each domain separately. On porkbun.com, open Domain Management, open the domain's details and switch on API Access. Then pull down to refresh the list in the app.

Only in your device's Keychain. They're sent to Porkbun's API and nowhere else. To remove them, open the person button → Disconnect and Remove Keys. This doesn't affect your Porkbun account. You can also delete the key itself at porkbun.com under API Access.

Porkbun offers sandbox keys (starting pk1_sb_) that connect to a separate test account with fake domains and credit, so you can try things without touching real DNS. The app shows a "Sandbox" label when they're in use. Email forwarding isn't available in Porkbun's sandbox.

Changes only go live if the domain uses Porkbun's nameservers. Check the domain's NS tab: if it says the domain isn't on Porkbun's nameservers, records you edit in the app (or at porkbun.com) won't be served. DNS changes can also take a few minutes to spread, longer for some resolvers.

The app looks up both. A records always get your public IPv4 address and AAAA records your IPv6 address, so they're never mixed. You can see both under the person button, and type a different address into a preset at any time.

A preset is a group of A and AAAA records across any of your domains that you point at one IP together, for example everything that points at a home server. Tap the lightning-bolt button, then Create from Existing Records to build one from records that already share an IP. Applying a preset shows exactly what will change first.

On mobile data your public IP belongs to your network provider, not your home, so pointing records at it would break them. Connect to the network the records should point at, or type the IP in.

It can, if the domain already receives mail elsewhere, because Porkbun's forwarding needs its own mail (MX) records. Before adding a forward the app asks Porkbun what would change, and if existing mail records would be removed or your SPF record rewritten, it shows you exactly which ones and asks you to confirm. Cancelling changes nothing.

Porkbun doesn't support catch-all forwarding. Add a forward for each address; one address can go to several inboxes, up to 20 forwards per domain.

Open the app once so it loads your domains, then long-press your Home Screen or Lock Screen, tap Edit → Add Widget and choose Porkbun Client. Red means a domain expires within 30 days without auto-renew; orange means it's within 30 days but will renew itself.

Turn them on under the person button → Expiry reminders, and choose how many days before expiry to be reminded. They arrive at 9am. The app refreshes in the background now and then so reminders stay right after a renewal, as long as Background App Refresh is on for the app.

For example "Which domains are expiring in Porkbun Client", "When does example.com expire in Porkbun Client" or "Apply Home server in Porkbun Client". The same actions are in the Shortcuts app. Anything that changes your domains asks you to confirm and needs your device unlocked.

None. There are no accounts, analytics, ads or tracking, and I don't run a server that receives your data. Everything is between your device and Porkbun. See the privacy policy for details.

Disconnect and remove your keys in the app, then delete the app. That removes everything it stored on your device. Since I never receive your data, there's nothing for me to delete.