SSL certificates
FreeThe SSL certificates page shows the WebDonkey Root CA and every certificate WebDonkey has issued for your sites. WebDonkey runs its own local certificate authority for this. It issues a certificate to every site with SSL, and once you trust it, your browser opens every local site on https:// without a warning.
What you do here
- Trust the root CA once: Trust the root CA.
- Check a certificate's validity and contents and renew it: Renew and inspect certificates.
- Turn SSL on or off for a site: in the site's form, see Create and edit a site.
Page layout
You reach the page in the sidebar under Local › SSL certificates, right below Sites. It has up to three groups. Each card has a coloured edge on the left whose colour shows what needs a look first.
- Certificate authority: the WebDonkey Root CA with its state (Trusted in keychain or Not trusted), its validity and the Trust now button while it is not trusted.
- Active: one certificate per site with SSL turned on. The number after the heading counts them. While there are none, a note says certificates show up as soon as you enable SSL on a site.
- SSL off: certificates of sites with SSL turned off. They stay saved. If the site no longer exists at all, the certificate is marked Orphaned.
Each card shows:
- the site's domain as its title, "WebDonkey Root CA" for the CA,
- its state: … days left or Expired,
- the domains it covers, aliases included,
- the period Valid from … until …,
- the path of the certificate file on your Mac,
- on the right Renew (not for the CA and not for orphaned certificates) and Details.
When is a certificate created?
When you turn on SSL via local WebDonkey CA for a site, WebDonkey issues the certificate right away. It covers the domain and every alias and is valid for 398 days, as long as browsers accept for server certificates. When you change the domain or aliases, WebDonkey reissues it on save. The root CA itself is valid for ten years.
The certificates live under ~/Library/Application Support/WebDonkey/certs/, one folder per site with cert.pem and key.pem. The root CA lives under ~/Library/Application Support/WebDonkey/ca/.
Free and Premium
On Free, at most three sites use SSL at the same time. When a Mac with more SSL sites moves from Premium to Free, WebDonkey asks with Choose your SSL sites which three keep SSL. Select them and click Apply selection. The others switch to HTTP, their certificates stay saved and come back with Premium. Premium lifts the limit. Prices: webdonkey.io/pricing.
Trust the root CA Free
The WebDonkey Root CA issues every certificate of your sites. For your browser to accept those certificates without a warning, you trust the root CA once on this Mac. From then on that applies to every site with SSL, including all the ones you create later.
Where to find it
Sidebar Local › SSL certificates, group Certificate authority. The WebDonkey Root CA card shows its state: Not trusted or Trusted in keychain.
How to do it
- Open the SSL certificates page.
- Click Trust now on the root CA. The button briefly shows Trusting….
- Confirm the macOS prompt.
- The card shows Trusted in keychain, its edge turns green.
- Reload a site with SSL in the browser. If the browser was already open, restart it if needed.
What happens in the background
- WebDonkey puts the root CA into the login keychain of your macOS user account. That needs no administrator password. Chrome, Safari and Firefox read this trust from the keychain.
- Before that, WebDonkey removes older WebDonkey CAs from the keychain, along with their trust settings.
- The root CA may only sign for certain names:
.test,localhost, loopback addresses and the domains of your sites. When a site gets a domain outside that list, such asclient.dev, WebDonkey replaces the CA with a successor that also covers that domain and reissues every site certificate. If the old CA was trusted, macOS asks once whether you trust the new one. If you decline, everything stays as it was. - PHP code that calls local HTTPS sites with
curltrusts the CA too: WebDonkey puts a bundle of the system certificates plus the root CA into the php.ini of its PHP versions.
Good to know
- The trust applies only on this Mac and only to your user account.
- You can revoke it at any time in Keychain Access. The certificate is called "WebDonkey Local Root CA" there.
- The CA's certificate and key live under
~/Library/Application Support/WebDonkey/ca/.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| The browser warns despite SSL | The CA is still Not trusted. | Click Trust now and confirm the prompt. |
| The warning stays after trusting | The browser still has the old state in memory. | Quit the browser completely and open it again. |
See also
Renew and inspect certificates Free
Every card on the SSL certificates page shows which domains a certificate covers, from when to when, and how long it has left. Renew issues a fresh certificate, Details shows its full contents.
Where to find it
Sidebar Local › SSL certificates, groups Active and SSL off. The buttons sit on the right of every card.
The traffic light
A card's state shows the time left (… days left) or Expired. Its edge, dot and icon share one colour:
| Colour | Meaning |
|---|---|
| Green | valid, more than 30 days left |
| Yellow | 30 days or fewer left |
| Red | Expired |
| Grey | The site has SSL turned off. |
For the root CA, the edge is green when it is trusted and yellow otherwise.
How to do it
Renew a certificate
- Find the site's card in the Active or SSL off group.
- Click Renew. The button briefly shows Renewing….
- The card shows the new period Valid from … until ….
A renewed certificate is valid for 398 days again. You can also renew the certificate of a site with SSL turned off, so it is ready when you turn SSL back on. Orphaned certificates whose site no longer exists have no Renew button.
Inspect the contents
Click Details. The card opens the certificate's full contents as openssl x509 -text prints them: issuer, serial number, validity, key and extensions. A second click closes them.
Find the file
Below the domains you see the path of the certificate file, such as ~/Library/Application Support/WebDonkey/certs/<id>/cert.pem. Next to it lies key.pem with the private key, in case you need both in another tool.
What happens in the background
Renew reissues the certificate for the site's domain and every alias, rewrites the site's configuration and reloads the web servers so they serve the new certificate right away. When you change a site's domain or aliases, WebDonkey renews its certificate by itself on save.
Troubleshooting
| What you see | Why | What to do |
|---|---|---|
| A site has no card | SSL was never turned on for it. | Turn on SSL via local WebDonkey CA in Create and edit a site. |
| The SSL checkbox is locked | On Free, three sites already use SSL. | See SSL certificates. |
| A message when renewing | The site could not be found or the certificate could not be written. | Read the message, then run the site diagnosis. |
| The browser warns despite a green card | The root CA is not trusted. | See Trust the root CA. |