1A2MD(1)                              a2md                              A2MD(1)
2
3
4

NAME

6       a2md - Show and manipulate Apache Managed Domains
7

SYNOPSIS

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

DESCRIPTION

13       The a2md utility can be used to configure and update managed domains
14       with the mod_md module for Apache HTTP Server. Managed Domains are
15       virtual hosts which automatically obtain and renew TLS certificates
16       from an ACME server.
17

OPTIONS

19       -a arg, --acme arg
20           The url of the ACME server directory
21
22       -d arg, --dir arg
23           Directory for file data
24
25       -h, --help
26           Print usage information
27
28       -j, --json
29           Produce JSON output
30
31       -p arg, --proxy arg
32           Use the HTTP proxy url
33
34       -q, --quiet
35           Produce less output
36
37       -t arg, --terms arg
38           You agree to the terms of services (url)
39
40       -v, --verbose
41           Produce more output
42
43       -V, --version
44           Print version
45
46   ACME server commands
47       a2md acme {newreg | delreg | agree | authz | validate} [opts] [args]
48
49       Play with the ACME server. For most of the commands you need to specify
50       the url of the ACME server directory.
51
52       newreg
53           newreg contact-uri [contact-uri...]
54
55           Register a new account at ACME server with given contact-uri
56           (email)
57
58       delreg
59           delreg account
60
61           Delete an existing ACME account
62
63       agree
64           agree account
65
66           Agree to ACME terms of service
67
68       authz
69           authz account domain
70
71           Request a new authorization for an account and domain
72
73       validate
74           validate account
75
76           Validate account existence
77
78   Managed domain addition
79       a2md add [opts] domain [domain...]
80
81       Adds a new managed domain. Must not overlap with existing domains.
82
83   Updating managed domain
84       a2md update name [opts] {domains | ca | account | contacts | agreement}
85
86       Update a managed domain's properties, where name belongs to managed
87       domain which will be updated.
88
89       URL of ACME server can be also updated if -a| --acme option is present.
90
91       domains
92           domains dname [dname...]
93
94           Update domain where dname is domain name which will be updated.
95
96       ca
97           ca url [proto]
98
99           The URL where the CA offers its service.
100
101           Currently only ACME (LetsEncrypt) proto is implemented.
102
103       account
104           account
105
106           Account name on corresponding ACME server.
107
108       contacts
109           contacts email [email...]
110
111           Contact address which will be used by ACME server to inform about
112           renewals or changed terms of service.
113
114       agreement
115           agreement URI
116
117           URI pointing to terms of service of ACME server.
118
119   Drive managed domains
120       a2md drive [md...] [options...]
121
122       Drive all or the mentioned managed domains toward completeness
123
124       Options
125           -c arg, --challenge arg
126               Which challenge type to use
127
128           -f, --force
129               Force driving the managed domain, even when it seems valid
130
131           -r, --reset
132               Reset any staging data for the managed domain
133
134   List managed domamins
135       a2md list
136
137       List all managed domains
138
139   Manipulating MD store
140       a2md store {add | remove | list | update} [opts] [args]
141
142       Manipulate the MD store
143
144       add
145           add dns [dns2...]
146
147           Add a new managed domain dns with all the additional domain names
148
149       remove
150           remove [-f | --force] name [name...]
151
152           Remove the managed domains name from the store
153
154           When -f or --force option is specified, force managed domain
155           removal - be silent about missing domains
156
157       list
158           list
159
160           List all managed domains in the store
161
162       update
163           update name [domains dname [dname...]]
164
165           If domains cmd is specified followed by one or more domains, MD
166           store will be updated with those domains.
167
168           URL of ACME server can be also updated if -a| --acme option is
169           present.
170

AUTHORS

172       Stefan Eissing <stefan.eissing@greenbytes.de>
173           Author
174
175       Lubos Uhliarik <luhliari@redhat.com>
176           Documentation
177
178
179
180mod_md                            07/20/2023                           A2MD(1)
Impressum