A2MD(1)

✨ A2MD(1) — the a2md manual, but make it cute 🎀

💖 NAME

okay so a2md is literally the tool for showing and manipulating Apache Managed Domains 🔥 bestie, you need this one.

🦋 SYNOPSIS

a2md [options] {acme | add | update | drive | list | store}
     [cmd options] [args]

🌸 DESCRIPTION

ngl the a2md utility is how you configure and update managed domains with the mod_md module for Apache HTTP Server 💅. Managed Domains are virtual hosts that automatically obtain and renew TLS certificates from an ACME server. it's giving set-it-and-forget-it 😭✨

🎀 OPTIONS

• -a arg, --acme arg — the url of the ACME server directory 🌈
• -d arg, --dir arg — directory for file data 📁
• -h, --help — print usage information 🙈
• -j, --json — produce JSON output 💜
• -p arg, --proxy arg — use the HTTP proxy url 🫶
• -q, --quiet — produce less output 🤫
• -t arg, --terms arg — you agree to the terms of services (url) 📜
• -v, --verbose — produce more output 🔊
• -V, --version — print version 🧚

🍓 ACME server commands

a2md acme {newreg | delreg | agree | authz | validate} [opts] [args]

play with the ACME server 💅 for most of these commands you need to specify the url of the ACME server directory.

newreg

newreg contact-uri [contact-uri...]

register a new account at the ACME server with the given contact-uri (email) ✉️

delreg

delreg account

delete an existing ACME account 🗑️

agree

agree account

agree to the ACME terms of service 📜

authz

authz account domain

request a new authorization for an account and domain 🔑

validate

validate account

validate account existence ✅

🌷 Managed domain addition

a2md add [opts] domain [domain...]

adds a new managed domain. it must not overlap with existing domains 🙅‍♀️

🌈 Updating managed domain

a2md update name [opts] {domains | ca | account | contacts | agreement}

update a managed domain's properties, where name is the managed domain that's getting updated 💖

the URL of the ACME server can also be updated if -a or --acme is present ✨

domains

domains dname [dname...]

update the domain where dname is the domain name that gets updated 🏡

ca

ca url [proto]

the URL where the CA offers its service 🏢

currently only ACME (LetsEncrypt) proto is implemented. only one option for now, bestie 🫠

account

account

account name on the corresponding ACME server 👤

contacts

contacts email [email...]

contact address the ACME server uses to inform you about renewals or changed terms of service 📬

agreement

agreement URI

URI pointing to the terms of service of the ACME server 📖

🧚 Drive managed domains

a2md drive [md...] [options...]

drive all of the mentioned managed domains toward completeness 🚗💨

Options

• -c arg, --challenge arg — which challenge type to use 🎯
• -f, --force — force driving the managed domain, even when it seems valid 💪
• -r, --reset — reset any staging data for the managed domain 🧹

🫧 List managed domamins

a2md list

list all managed domains 📋

💜 Manipulating MD store

a2md store {add | remove | list | update} [opts] [args]

manipulate the MD store 🗄️

add

add dns [dns2...]

add a new managed domain dns with all the additional domain names 🌟

remove

remove [-f | --force] name [name...]

remove the managed domains name from the store 👋

when -f or --force is specified, force the managed domain removal and be silent about missing domains 🤫

list

list

list all managed domains in the store 📚

update

update name [domains dname [dname...]]

if the domains command is specified followed by one or more domains, the MD store will be updated with those domains 🔄

the URL of the ACME server can also be updated if -a or --acme is present 💅

👑 AUTHORS

Stefan Eissing <stefan.eissing@greenbytes.de> — author 💜

Lubos Uhliarik <luhliari@redhat.com> — documentation 🎀

---

mod_md · 05/10/2026 · A2MD(1) — that's a wrap, bestie! 🌈💖 periodt 💅✨