Getting started

Note

The default settings are for users looking to install a regular (non-wildcard) certificate for an IIS web server running on the same machine. For any other scenario you should skip straight to the section on advanced use.
  • Install simple-acme on your web server using any method.
  • Choose N in the main menu to create a new certificate with default settings.
  • Choose the website(s) and binding(s) that you want to create a certificate for.
  • You may get a popup from your firewall requesting permission for the program to listen to incoming requests on port 80 and 443. This is required for the default validation method. If you refuse, you can pick another validation method instead.
  • An account is created at the ACME server (which is Let’s Encrypt by default). You will be asked to agree to the terms of service and to (optionally) provide an email address that the administrators can use to contact you.
  • The program negotiates with the server to try and prove your ownership of the domain(s) that you want to create the certificate for. By default the HTTP validation mode is used, handled by our self-hosting plugin. Getting validation right is often the most tricky part of getting an ACME certificate. If there are problems please check out some common issues.
  • After the proof has been provided, the program downloads the new certificate from the server, installs it into the Windows Certificate Store and updates or creates IIS bindings as required. Note that the program is deliberately conservative in creating new bindings, so the first time you may need to add additional ones manually, e.g. if you’re running the same host name on multiple ports.
  • The program remembers all choices that you made while creating the certificate and applies them for each subsequent renewal. It also recognizes when an ACME certificate has been manually added to any other web or ftp site and updates those automatically upon replacement.
  • A scheduled task is created in the Windows Task Scheduler, which will run the program every day. Every day the task runs, several methods are used to determine whether one ore more certificates managed by the program are supposed to be renewed on that particular day.

Looking for win-acme?

simple-acme is a backwards compatible, drop-in replacement built by the same person. Project history.