Skip to content

Conversation

@1r0n3d3v3l0per
Copy link

Description

Add dns_apertodns.sh plugin for ApertoDNS dynamic DNS service.

Features

  • DNS-01 challenge support for Let's Encrypt certificates
  • Works with standard domains (*.apertodns.com) and custom domains
  • Uses ApertoDNS Protocol API for TXT record management
  • Supports API key authentication

Usage

export APERTODNS_API_KEY="your-api-key"
acme.sh --issue --dns dns_apertodns -d example.apertodns.com

Documentation

Testing

Tested successfully with:

  • Standard domains (*.apertodns.com)
  • Custom domains with AWS Route53 backend
  • TXT record creation and deletion verified via DNS queries

neilpang and others added 2 commits January 13, 2026 21:50
Add dns_apertodns.sh for ApertoDNS dynamic DNS service.

Features:
- DNS-01 challenge support for Let's Encrypt
- Works with standard (*.apertodns.com) and custom domains
- Uses ApertoDNS Protocol API v1.2

Usage:
  export APERTODNS_API_KEY="your-api-key"
  acme.sh --issue --dns dns_apertodns -d example.apertodns.com

Documentation: https://github.com/apertodns/acme-dns-apertodns
@github-actions
Copy link

Welcome
READ ME !!!!!
Read me !!!!!!
First thing: don't send PR to the master branch, please send to the dev branch instead.
Please read the DNS API Dev Guide.
You MUST pass the DNS-API-Test.
Then reply on this message, otherwise, your code will not be reviewed or merged.
Please also make sure to add/update the usage here: https://github.com/acmesh-official/acme.sh/wiki/dnsapi2
注意: 必须通过了 DNS-API-Test 才会被 review. 无论是修改, 还是新加的 dns api, 都必须确保通过这个测试.

@1r0n3d3v3l0per 1r0n3d3v3l0per changed the base branch from master to dev January 17, 2026 16:40
@1r0n3d3v3l0per
Copy link
Author

DNS API Test Results

Successfully tested on Ubuntu 22.04 with Let's Encrypt staging environment:

[Sat Jan 17 16:44:57 UTC 2026] Using ApertoDNS API
[Sat Jan 17 16:44:57 UTC 2026] Adding TXT record for brave-panda.apertodns.com
[Sat Jan 17 16:44:58 UTC 2026] TXT record added successfully
[Sat Jan 17 16:45:18 UTC 2026] Success for domain brave-panda.apertodns.com '_acme-challenge.brave-panda.apertodns.com'.
[Sat Jan 17 16:45:18 UTC 2026] All checks succeeded
[Sat Jan 17 16:45:26 UTC 2026] Your cert is in: /home/ubuntu/.acme.sh/brave-panda.apertodns.com_ecc/brave-panda.apertodns.com.cer

Certificate issued successfully:

  • Subject: CN = brave-panda.apertodns.com
  • Issuer: (STAGING) Let's Encrypt
  • Valid: 90 days

Wiki Documentation (for dnsapi2 page)

dns_apertodns

ApertoDNS provides free dynamic DNS for .apertodns.com subdomains.

First, get your API key from the ApertoDNS dashboard.

export APERTODNS_API_KEY="apertodns_live_xxxxxxxx"

To issue a certificate:

acme.sh --issue --dns dns_apertodns -d myhost.apertodns.com

For wildcard certificates:

acme.sh --issue --dns dns_apertodns -d myhost.apertodns.com -d '*.myhost.apertodns.com'

The APERTODNS_API_KEY will be saved in ~/.acme.sh/account.conf and reused for future requests.

Optionally, you can specify a custom API URL:

export APERTODNS_API_URL="https://api.apertodns.com"

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants