caddy-dns-omglol

omg.lol DNS provider module for Caddy.

This package registers a Caddy module (dns.providers.omglol) that allows Caddy's built-in ACME client to complete DNS-01 challenges for domains hosted on omg.lol. It wraps libdns-omglol.

Caddy module name

dns.providers.omglol

Building Caddy with this plugin

With xcaddy

xcaddy build --with github.com/folone/caddy-dns-omglol

With Docker

A Dockerfile is included in this repository. Build it with:

docker build -t caddy-omglol .
docker run --rm -v $PWD/Caddyfile:/etc/caddy/Caddyfile caddy-omglol

Or extract just the binary:

docker create --name tmp caddy-omglol
docker cp tmp:/usr/bin/caddy ./caddy
docker rm tmp

Configuration

Caddyfile

Global (applies to all sites):

{
    acme_dns omglol {
        api_key  {env.OMGLOL_API_KEY}
        address  yourname
    }
}

Per-site:

yourname.omg.lol {
    tls {
        dns omglol {
            api_key {env.OMGLOL_API_KEY}
            address yourname
        }
    }
}

address is your omg.lol handle — the part before .omg.lol (e.g. yourname for yourname.omg.lol).

JSON

{
  "module": "acme",
  "challenges": {
    "dns": {
      "provider": {
        "name": "omglol",
        "api_key": "{env.OMGLOL_API_KEY}",
        "address": "yourname"
      }
    }
  }
}

Getting your API key

Your omg.lol API key is available in your account settings. It is recommended to supply it via an environment variable rather than hard-coding it in your Caddyfile.

Related

• libdns-omglol — the underlying libdns provider
• Caddy DNS challenges
• xcaddy
• omg.lol API docs