cmd/certbot - Revision history

Woozle: plugin sel section

2022-11-28T01:35:48Z

plugin sel section

@@ Line 170: / Line 170: @@
 |-
 |    || --reason                  || {{arg|option}}  || revoke || {{arg|option}} can be: unspecified, keycompromise, affiliationchanged, superseded, cessationofoperation
-<br>Specify reason for revoking certificate. (default: unspecified)
+Specify reason for revoking certificate. (default: unspecified)
 |-
 |    || --delete-after-revoke     ||                 || revoke || Delete certificates after revoking them, along with all previous and later versions of those certificates. (default: None)
 |-
 |    || --no-delete-after-revoke  ||                 || revoke ||  Do not delete certificates after revoking them. This option should be used with caution because the 'renew' subcommand will attempt to renew undeleted revoked certificates. (default: None)
 |}
 ==Commands==
 ===get/renew===
 obtain, install, and renew certificates:

Woozle: revoke section

2022-11-28T01:09:04Z

revoke section

← Older revision		Revision as of 01:09, 28 November 2022
Line 168:		Line 168:
	\|-		\|-
	\| \|\| --no-autorenew \|\| \|\| renew \|\| Disable auto renewal of certificates. (default: True)		\| \|\| --no-autorenew \|\| \|\| renew \|\| Disable auto renewal of certificates. (default: True)
			\|-
			\| \|\| --reason \|\| {{arg\|option}} \|\| revoke \|\| {{arg\|option}} can be: unspecified, keycompromise, affiliationchanged, superseded, cessationofoperation
			<br>Specify reason for revoking certificate. (default: unspecified)
			\|-
			\| \|\| --delete-after-revoke \|\| \|\| revoke \|\| Delete certificates after revoking them, along with all previous and later versions of those certificates. (default: None)
			\|-
			\| \|\| --no-delete-after-revoke \|\| \|\| revoke \|\| Do not delete certificates after revoking them. This option should be used with caution because the 'renew' subcommand will attempt to renew undeleted revoked certificates. (default: None)
	\|}		\|}
	==Commands==		==Commands==

Woozle: renew section, and some other stuff

2022-11-28T01:05:38Z

renew section, and some other stuff

@@ Line 1: / Line 1: @@
 This documentation is being constructed from the {{l/sub|manpage}}, for better searchability ({{hilite|under construction 2022-11-25}}):
 ==Options==
@@ Line 151: / Line 152: @@
 |-
 |    || --server                || {{arg|URI}}       || paths || ACME Directory Resource URI. (default: https://acme-v02.api.letsencrypt.org/directory)
 |}
 ==Commands==
@@ Line 161: / Line 179: @@
 ===manage===
 manage certificates:
-* {{l/sub|certificates}}: Display information about certificates you have from Certbot
+* {{l/sub|certificates}}: Display information about certificates managed by Certbot
 * {{l/sub|revoke}}: Revoke a certificate (supply --cert-path or --cert-name)
-* {{l/sub|delete}}: Delete a certificate
+* {{l/sub|delete}}: Delete a certificate and clean up all related files
 ===account===
 Manage your ACME account:

Woozle: paths section

2022-11-28T00:46:49Z

paths section

@@ Line 135: / Line 135: @@
 |-
 |    || --break-my-certs        ||          || testing || Be willing to replace or renew valid certificates with invalid (testing/staging) certificates (default: False)
 |}
 ==Commands==

Woozle: testing section

2022-11-28T00:41:47Z

testing section

@@ Line 121: / Line 121: @@
 |-
 |    || --auto-hsts             ||          || security || Gradually increasing max-age value for HTTP Strict Transport Security security header (default: False)
 |}
 ==Commands==

Woozle at 00:36, 28 November 2022

2022-11-28T00:36:20Z

@@ Line 102: / Line 102: @@
 |    || --no-permissions-check  ||     || automation || (certbot-auto only) skip the check on the file system permissions of the certbot-auto script (default: False)
 |-
-| -q  || --quiet                ||     || automation || Silence all output except errors. Useful for automation via cron. Implies --non-interactive. (default: False)
+| -q || --quiet                 ||     || automation || Silence all output except errors. Useful for automation via cron. Implies --non-interactive. (default: False)
 |}
 ==Commands==

Woozle at 16:19, 26 November 2022

2022-11-26T16:19:18Z

@@ Line 1: / Line 1: @@
-This documentation is being constructed from the manpage, for better searchability ({{hilite|under construction 2022-11-25}}):
+This documentation is being constructed from the {{l/sub|manpage}}, for better searchability ({{hilite|under construction 2022-11-25}}):
 ==Options==
 {| class="wikitable sortable"
@@ Line 5: / Line 5: @@
 |-
 | -d ||              || {{arg|domain list}} || get/renew || Comma-separated list of domains to obtain a certificate for, or to otherwise apply.
-For multiple domains you can use multiple -d flags or enter a comma separated list of domains as a parameter. The first domain provided will be the subject CN of the certificate, and all domains will be Subject Alternative Names on the certificate. The first domain will also be used in some software user interfaces and as the file paths
+For multiple domains you can use multiple -d flags or enter a comma separated list of domains as a parameter. The first domain provided will be the subject CN of the certificate, and all domains will be Subject Alternative Names on the certificate. The first domain will also be used in some software user interfaces and as the file paths for the certificate and related material unless otherwise specified or you already have a certificate with the same name. In the case of a name collision it will append a number like 0001 to the file path name. (default: Ask)
 |-
 |    || --apache     ||                     || get/renew || Use the Apache plugin for authentication & installation
@@ Line 41: / Line 41: @@
 | Run without ever asking for user input. This may require additional command line flags; the client will try to explain which ones are required if it finds one missing (default: False)
 |-
-|    || --force-interactive ||              || general || Force Certbot to be interactive even if it detects it's not being run in a terminal. This flag cannot be used with the renew subcommand. (default: False)
+|    || --force-interactive ||                  || general || Force Certbot to be interactive even if it detects it's not being run in a terminal. This flag cannot be used with the renew subcommand. (default: False)
 |}
 ==Commands==

Woozle at 02:03, 26 November 2022

2022-11-26T02:03:36Z

← Older revision		Revision as of 02:03, 26 November 2022
Line 1:		Line 1:
	~~Table~~ constructed from the manpage, for better searchability ({{hilite\|under construction 2022-11-25}}):		This documentation is being constructed from the manpage, for better searchability ({{hilite\|under construction 2022-11-25}}):
			==Options==
	{\| class="wikitable sortable"		{\| class="wikitable sortable"
	! short \|\| long \|\| subsystem \|\| description		! short \|\| long \|\| arguments \|\| subsystem \|\| description
	\|-		\|-
	\| -d {{arg\|domain list}} \|\| get/renew \|\| Comma-separated list of domains to obtain a certificate for		\| -d \|\| \|\| {{arg\|domain list}} \|\| get/renew \|\| Comma-separated list of domains to obtain a certificate for, or to otherwise apply.
			For multiple domains you can use multiple -d flags or enter a comma separated list of domains as a parameter. The first domain provided will be the subject CN of the certificate, and all domains will be Subject Alternative Names on the certificate. The first domain will also be used in some software user interfaces and as the file paths
	\|-		\|-
	\| \|\| --apache \|\| get/renew \|\| Use the Apache plugin for authentication & installation		\| \|\| --apache \|\| \|\| get/renew \|\| Use the Apache plugin for authentication & installation
	\|-		\|-
	\| \|\| --standalone \|\| get/renew \|\| Run a standalone webserver for authentication		\| \|\| --standalone \|\| \|\| get/renew \|\| Run a standalone webserver for authentication
	\|-		\|-
	\| \|\| --nginx \|\| get/renew \|\| Use the Nginx plugin for authentication & installation		\| \|\| --nginx \|\| \|\| get/renew \|\| Use the Nginx plugin for authentication & installation
	\|-		\|-
	\| \|\| --webroot \|\| get/renew \|\| Place files in a server's webroot folder for authentication		\| \|\| --webroot \|\| \|\| get/renew \|\| Place files in a server's webroot folder for authentication
	\|-		\|-
	\| \|\| --manual \|\| get/renew \|\| Obtain certificates interactively, or using shell script hooks		\| \|\| --manual \|\| \|\| get/renew \|\| Obtain certificates interactively, or using shell script hooks
	\|-		\|-
	\| -n \|\| \|\| get/renew \|\| Run non-interactively		\| -n \|\| \|\| \|\| get/renew \|\| Run non-interactively
	\|-		\|-
	\| \|\| --test-cert \|\| get/renew \|\| Obtain a test certificate from a staging server		\| \|\| --test-cert \|\| \|\| get/renew \|\| Obtain a test certificate from a staging server
	\|-		\|-
	\| \|\| --dry-run \|\| get/renew \|\| Test "renew" or "certonly" without saving any certificates		\| \|\| --dry-run \|\| \|\| get/renew \|\| Test "renew" or "certonly" without saving any certificates
	\|-		\|-
	\| \|\| --agree-tos \|\| account \|\| Agree to the ACME server's Subscriber Agreement\		\| \|\| --agree-tos \|\| \|\| account \|\| Agree to the ACME server's Subscriber Agreement
	\|-		\|-
	\| -m {{arg\|email addr}} \|\| \|\| account \|\| Email address for important account notifications		\| -m \|\| \|\| {{arg\|email addr}} \|\| account \|\| Email address for important account notifications
			\|-
			\| -h \|\| --help \|\| \|\| general \|\| show a help message and exit
			\|-
			\| -c \|\| --config \|\| {{arg\|config file}} \|\| general \|\| path to config file (default: /etc/letsencrypt/cli.ini and ~/.config/letsencrypt/cli.ini)
			\|-
			\| -v \|\| --verbose \|\| \|\| general \|\| This flag can be used multiple times to incrementally increase the verbosity of output, e.g. -vvv. (default: -2)
			\|-
			\| \|\| --max-log-backups \|\| {{arg\|number}} \|\| general \|\| Specifies the maximum number of backup logs that should be kept by Certbot's built in log rotation. Setting this flag to 0 disables log rotation entirely, causing Certbot to always append to the same log file. (default: 1000)
			\|-
			\| -n
			\| --non-interactive<br>--noninteractive
			\|
			\| general
			\| Run without ever asking for user input. This may require additional command line flags; the client will try to explain which ones are required if it finds one missing (default: False)
			\|-
			\| \|\| --force-interactive \|\| \|\| general \|\| Force Certbot to be interactive even if it detects it's not being run in a terminal. This flag cannot be used with the renew subcommand. (default: False)
	\|}		\|}
			==Commands==
			===get/renew===
			obtain, install, and renew certificates:
			* {{l/sub\|run}} (default): Obtain & install a certificate in your current webserver
			* {{l/sub\|certonly}}: Obtain or renew a certificate, but do not install it
			* {{l/sub\|renew}}: Renew all previously obtained certificates that are near expiry
			* {{l/sub\|enhance}}: Add security enhancements to your existing configuration
			===manage===
			manage certificates:
			* {{l/sub\|certificates}}: Display information about certificates you have from Certbot
			* {{l/sub\|revoke}}: Revoke a certificate (supply --cert-path or --cert-name)
			* {{l/sub\|delete}}: Delete a certificate
			===account===
			Manage your ACME account:
			* {{l/sub\|register}}: Create an ACME account
			* {{l/sub\|unregister}}: Deactivate an ACME account
			* {{l/sub\|update_account}}: Update an ACME account

Woozle: Created page with "Table constructed from the manpage, for better searchability ({{hilite|under construction 2022-11-25}}): {| class="wikitable sortable" ! short || long || subsystem || descrip..."

2022-11-26T01:43:31Z

Created page with "Table constructed from the manpage, for better searchability ({{hilite|under construction 2022-11-25}}): {| class="wikitable sortable" ! short || long || subsystem || descrip..."

New page

Table constructed from the manpage, for better searchability ({{hilite|under construction 2022-11-25}}):

{| class="wikitable sortable"
! short || long || subsystem || description
|-
| -d {{arg|domain list}} || get/renew || Comma-separated list of domains to obtain a certificate for
|-
| || --apache || get/renew || Use the Apache plugin for authentication & installation
|-
| || --standalone || get/renew || Run a standalone webserver for authentication
|-
| || --nginx || get/renew || Use the Nginx plugin for authentication & installation
|-
| || --webroot || get/renew || Place files in a server's webroot folder for authentication
|-
| || --manual || get/renew || Obtain certificates interactively, or using shell script hooks
|-
| -n || || get/renew || Run non-interactively
|-
| || --test-cert || get/renew || Obtain a test certificate from a staging server
|-
| || --dry-run || get/renew || Test "renew" or "certonly" without saving any certificates
|-
| || --agree-tos || account || Agree to the ACME server's Subscriber Agreement\
|-
| -m {{arg|email addr}} || || account || Email address for important account notifications
|}