1 Name = "Manual"
2 Description = '''Solving the DNS-01 challenge using CLI prompt.'''
3 Code = "manual"
4 Since = "v0.3.0"
5 6 Example = '''
7 lego --dns manual -d '*.example.com' -d example.com run
8 '''
9 10 Additional = '''
11 ## Example
12 13 To start using the CLI prompt "provider", start lego with `--dns manual`:
14 15 ```console
16 $ lego --dns manual -d example.com run
17 ```
18 19 What follows are a few log print-outs, interspersed with some prompts, asking for you to do perform some actions:
20 21 ```txt
22 No key found for account you@example.com. Generating a P256 key.
23 Saved key to ./.lego/accounts/acme-v02.api.letsencrypt.org/you@example.com/keys/you@example.com.key
24 Please review the TOS at https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf
25 Do you accept the TOS? Y/n
26 ```
27 28 If you accept the linked Terms of Service, hit `Enter`.
29 30 ```txt
31 [INFO] acme: Registering account for you@example.com
32 !!!! HEADS UP !!!!
33 34 Your account credentials have been saved in your Let's Encrypt
35 configuration directory at "./.lego/accounts".
36 37 You should make a secure backup of this folder now. This
38 configuration directory will also contain certificates and
39 private keys obtained from Let's Encrypt so making regular
40 backups of this folder is ideal.
41 [INFO] [example.com] acme: Obtaining bundled SAN certificate
42 [INFO] [example.com] AuthURL: https://acme-v02.api.letsencrypt.org/acme/authz-v3/2345678901
43 [INFO] [example.com] acme: Could not find solver for: tls-alpn-01
44 [INFO] [example.com] acme: Could not find solver for: http-01
45 [INFO] [example.com] acme: use dns-01 solver
46 [INFO] [example.com] acme: Preparing to solve DNS-01
47 lego: Please create the following TXT record in your example.com. zone:
48 _acme-challenge.example.com. 120 IN TXT "hX0dPkG6Gfs9hUvBAchQclkyyoEKbShbpvJ9mY5q2JQ"
49 lego: Press 'Enter' when you are done
50 ```
51 52 Do as instructed, and create the TXT records, and hit `Enter`.
53 54 ```txt
55 [INFO] [example.com] acme: Trying to solve DNS-01
56 [INFO] [example.com] acme: Checking DNS record propagation using [192.168.8.1:53]
57 [INFO] Wait for propagation [timeout: 1m0s, interval: 2s]
58 [INFO] [example.com] acme: Waiting for DNS record propagation.
59 [INFO] [example.com] The server validated our request
60 [INFO] [example.com] acme: Cleaning DNS-01 challenge
61 lego: You can now remove this TXT record from your example.com. zone:
62 _acme-challenge.example.com. 120 IN TXT "hX0dPkG6Gfs9hUvBAchQclkyyoEKbShbpvJ9mY5q2JQ"
63 [INFO] [example.com] acme: Validations succeeded; requesting certificates
64 [INFO] [example.com] Server responded with a certificate.
65 ```
66 67 As mentioned, you can now remove the TXT record again.
68 69 '''
70