Buy

SSL certificates

Free

The 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

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

  1. Open the SSL certificates page.
  2. Click Trust now on the root CA. The button briefly shows Trusting….
  3. Confirm the macOS prompt.
  4. The card shows Trusted in keychain, its edge turns green.
  5. 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 as client.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 curl trusts 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

  1. Find the site's card in the Active or SSL off group.
  2. Click Renew. The button briefly shows Renewing….
  3. 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.

See also

Cookie preferences

This website uses cookies to ensure the best experience possible. Your choice applies to webdonkey.io and the shop at shop.webdonkey.io. More information...

Technically required

Cookies required for this website to function:

Always on
WebDonkey
WebDonkey
Provider: BuI Hinsche GmbH, Neumarkt 7, 06712 Zeitz, Germany
Purpose: Your consent, colour scheme and language for website and shop, price switches; with wd_debug in the address, the measurement events in the developer console for troubleshooting
Cookies and storage: Cookie wd_consent on .webdonkey.io, shared with shop.webdonkey.io (12 months); cookies wd_theme and wd_lang on .webdonkey.io, shared with shop.webdonkey.io, only when you switch colour scheme or language yourself (365 days); localStorage wd:consent, wd:theme, wd:lang; sessionStorage wd:acc, wd:term, wd:debug (only with wd_debug in the address; until the tab closes)

Statistics

Shows us which pages and products people look at on webdonkey.io and in the shop, where visitors come from and how they get to a purchase (with order number, amount and products, without name or email address). Provider: Google. Transfer to the USA possible (EU-US Data Privacy Framework). Your choice applies to webdonkey.io and the shop together.

Google Tag Manager, Google Analytics 4
Google Tag Manager
Provider: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Purpose: Loads the services you agreed to, here and in the shop. Sets no cookies of its own.
Cookies and storage: none
Privacy policy
Google Analytics 4
Provider: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Purpose: Usage statistics: page views, clicks, scroll depth, sources, devices, load times; in the shop also basket, checkout, purchases, registration and sign-in
Cookies and storage: _ga, _ga_<ID> (2 years)
Privacy policy

Marketing

Measures whether our ads on Facebook, Instagram and TikTok lead to visits and downloads on webdonkey.io and to registrations and purchases in the shop, and builds audiences for ads. Providers: Meta and TikTok, with whom we are jointly responsible for this. With this consent Google may also set advertising cookies (_gcl_…). Transfer to the USA and other countries outside the EU possible. Your choice applies to webdonkey.io and the shop together.

Google Tag Manager, Meta Pixel (Facebook, Instagram), TikTok Pixel
Google Tag Manager
Provider: Google Ireland Limited, Gordon House, Barrow Street, Dublin 4, Ireland
Purpose: Loads the services you agreed to, here and in the shop. Sets no cookies of its own.
Cookies and storage: none
Privacy policy
Meta Pixel (Facebook, Instagram)
Provider: Meta Platforms Ireland Limited, Merrion Road, Dublin 4, D04 X2K5, Ireland
Purpose: Ad measurement and target groups on Facebook and Instagram, also in the shop (basket, checkout, purchases, registration)
Cookies and storage: _fbp (3 months), _fbc (3 months, only if you arrive through an ad), fr on facebook.com (3 months)
Privacy policy
TikTok Pixel
Provider: TikTok Technology Limited, 10 Earlsfort Terrace, Dublin, D02 T380, Ireland
Purpose: Ad measurement and target groups on TikTok, also in the shop (basket, checkout, purchases, registration)
Cookies and storage: _ttp, _tt_enable_cookie (13 months)
Privacy policy