Filesystem
Save verification files on (network) path
| Plugin type | HTTP validation | |
|---|---|---|
| Download | Built-in | |
| Compatibility | All platforms |
Description
This plugin saves the validation challenge to a local or network path.
If you plan to use this plugin to serve files via IIS, consider using the default self-hosting instead, as self-hosting avoids many configuration issues that you might run into before IIS will properly serve validation files.
web.config
Optionally this plugin can place a web.config next to the validation file, to
help IIS properly serve the response. This automatically fixes some of the issues mentioned in
IIS configuration. In interactive mode the program
will ask you if you want to do this. In unattended mode you can request it using the
command line toggle --manualtargetisiis (if the source is IIS, this is automatically applied).
The web.config that will be copied lives in the root of the program directory with the
name web_config.xml. You can modify it to fit your needs. Let us know if you could use a similar feature for uploading an .htaccess!
Command line
--validation filesystem |
Activates the plugin | |
|---|---|---|
‑‑validationsiteid |
Specify IIS site to use for handling validation requests. This will be used to choose the web root path. | |
‑‑webroot |
Root path of the website. Note that /.well-known/acme-challenge/ will be appended automatically. Use ‑‑challengeroot instead if you do not want this to happen, e.g. to use a credential with limited access. | |
‑‑challengeroot |
Root path for the /.well-known/acme-challenge/ folder for this domain. | |
‑‑manualtargetisiis |
Copy default web.config to the .well-known directory. |
Examples
| Path from IIS | --validation filesystem ‑‑validationsiteid 1 |
|
|---|---|---|
| Manual path | --validation filesystem ‑‑webroot c:\httpdocs\ |
JSON
| ID | 1c77b3a4-5310-4c46-92c6-00d866e84d6b |
|---|
Settings
Validation.CleanupFolders |
If set to true, the program will automatically delete file it created after HTTP validation is complete. It will also cleanup the ./well-known/acme-challenge folder, if (and only if) there are no other files present.
Type: boolean Default: true
|
|---|
Looking for win-acme?
simple-acme is a backwards compatible, drop-in replacement built by the same person. Project history.