zoneedit

package module
v0.0.0-...-7c8620e Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 5, 2026 License: MIT Imports: 4 Imported by: 0

README

Zoneedit module for Caddy

This package contains a DNS provider module for Caddy. It can be used to manage DNS records with Zoneedit.

Caddy module name

dns.providers.zoneedit

Config examples

To use this module for the ACME DNS challenge, configure the ACME issuer in your Caddy JSON like so:

{
	"module": "acme",
	"challenges": {
		"dns": {
			"provider": {
				"name": "zoneedit",
				"user": "YOUR_ZONEEDIT_USER",
				"auth_token": "YOUR_ZONEEDIT_AUTH_TOKEN"
			}
		}
	}
}

or with the Caddyfile:

# globally
{
	acme_dns zoneedit <user> <auth_token>
}
# one site
tls {
	dns zoneedit <user> <auth_token>
}

Authentication

Zoneedit requires a username and an authentication token. You can find your authentication token in the Zoneedit control panel under the "DYN" or "Dynamic DNS" settings for your domain.

Caveats

Zoneedit's API has a rate limit of one request per 10 seconds. This module automatically sleeps for 11 seconds after each creation or deletion of a record to comply with this limit. This will make the DNS challenge process take longer than with other providers.

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Provider

type Provider struct {
	*libdns.Provider
}

Provider lets Caddy read and manipulate DNS records hosted by Zoneedit.

func (Provider) CaddyModule

func (Provider) CaddyModule() caddy.ModuleInfo

CaddyModule returns the Caddy module information.

func (*Provider) Provision

func (p *Provider) Provision(ctx caddy.Context) error

Provision sets up the module. Implements caddy.Provisioner.

func (*Provider) UnmarshalCaddyfile

func (p *Provider) UnmarshalCaddyfile(d *caddyfile.Dispenser) error

UnmarshalCaddyfile sets up the DNS provider from Caddyfile tokens. Syntax:

zoneedit <user> <auth_token> {
    user <user>
    auth_token <auth_token>
}

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL