Skip to content

Updated the LetsEncrypt SSL installation process instructions for DigitalOcean #77

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Updated the LetsEncrypt SSL installation process instructions for DigitalOcean #77

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0266ff4
Update digitalocean.md SSL process
AMDphreak Dec 10, 2024
7ea2f1d
Merge pull request #1 from AMDphreak/AMDphreak-updated-digitalocean-s…
AMDphreak Dec 10, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
54 changes: 52 additions & 2 deletions install/digitalocean.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -94,7 +94,7 @@ By default, requests made to the HTTP port will not be redirect to HTTPS. You ca

## Renew the Certificate

You can renew the certificate at any time from the **Administration Area** > **SSL**.
You can renew the certificate at any time from the **Administration Area** > **SSL**.

If your certificate has expired and you cannot load the wiki UI to renew it, simply restart the container:

Expand All @@ -104,6 +104,56 @@ docker restart wiki

The renewal process will run automatically during initialization.

The certificate will not be renewed, if it is not close enough to expiry (1 to 3 days). If a renewal is requested, the GUI will state that renewal has failed, while the docker logs will state that the certificate was issued due to being almost expired, but the old certificate was used, without explaining why. Example log:

```
root@wikiJS-GSO:~# docker logs wiki
Loading configuration from /wiki/config.yml... OK
.
. random stuff
.
2024-12-10T22:03:26.988Z [MASTER] info: (LETSENCRYPT) Certificate is about to or has expired, requesting a new one...
2024-12-10T22:03:26.989Z [MASTER] info: (LETSENCRYPT) Initializing Let's Encrypt client...
2024-12-10T22:03:27.050Z [MASTER] info: HTTP Server: [ RUNNING ]
2024-12-10T22:03:27.211Z [MASTER] info: (LETSENCRYPT) Generating certificate signing request (CSR)...
2024-12-10T22:03:27.219Z [MASTER] info: (LETSENCRYPT) CSR generated successfully [ OK ]
2024-12-10T22:03:27.220Z [MASTER] info: (LETSENCRYPT) Requesting certificate from Let's Encrypt...
2024-12-10T22:03:27.225Z [MASTER] info: (LETSENCRYPT) Setting HTTP challenge for wiki.mywebsite.com: [ READY ]
2024-12-10T22:03:27.225Z [MASTER] info: (LETSENCRYPT) Waiting for challenge to complete...
2024-12-10T22:03:27.317Z [MASTER] info: Telemetry is active: [ OK ]
2024-12-10T22:03:32.240Z [MASTER] info: (LETSENCRYPT) Received valid challenge request. [ ACCEPTED ]
2024-12-10T22:03:32.244Z [MASTER] info: (LETSENCRYPT) Removing HTTP challenge: [ OK ]
2024-12-10T22:03:32.736Z [MASTER] info: (LETSENCRYPT) Setting HTTP challenge for wiki.mywebsite.com: [ READY ]
2024-12-10T22:03:32.736Z [MASTER] info: (LETSENCRYPT) Waiting for challenge to complete...
2024-12-10T22:03:37.741Z [MASTER] info: (LETSENCRYPT) Received valid challenge request. [ ACCEPTED ]
2024-12-10T22:03:38.025Z [MASTER] info: (LETSENCRYPT) Received valid challenge request. [ ACCEPTED ]
2024-12-10T22:03:38.424Z [MASTER] info: (LETSENCRYPT) Received valid challenge request. [ ACCEPTED ]
2024-12-10T22:03:38.451Z [MASTER] info: (LETSENCRYPT) Received valid challenge request. [ ACCEPTED ]
2024-12-10T22:03:38.679Z [MASTER] info: (LETSENCRYPT) Received valid challenge request. [ ACCEPTED ]
2024-12-10T22:03:38.681Z [MASTER] info: (LETSENCRYPT) Received valid challenge request. [ ACCEPTED ]
2024-12-10T22:03:39.078Z [MASTER] info: (LETSENCRYPT) Received valid challenge request. [ ACCEPTED ]
2024-12-10T22:03:39.272Z [MASTER] info: (LETSENCRYPT) Received valid challenge request. [ ACCEPTED ]
2024-12-10T22:03:39.319Z [MASTER] info: (LETSENCRYPT) Received valid challenge request. [ ACCEPTED ]
2024-12-10T22:03:39.529Z [MASTER] info: (LETSENCRYPT) Received valid challenge request. [ ACCEPTED ]
2024-12-10T22:03:39.649Z [MASTER] info: (LETSENCRYPT) Received valid challenge request. [ ACCEPTED ]
2024-12-10T22:03:39.929Z [MASTER] info: (LETSENCRYPT) Removing HTTP challenge: [ OK ]
2024-12-10T22:03:40.280Z [MASTER] info: (LETSENCRYPT) New certificate received successfully: [ COMPLETED ]
.
. more stuff
.
2024-12-10T22:07:03.577Z [MASTER] info: (LETSENCRYPT) Initializing Let's Encrypt client...
2024-12-10T22:07:03.699Z [MASTER] info: (LETSENCRYPT) Generating certificate signing request (CSR)...
2024-12-10T22:07:03.703Z [MASTER] info: (LETSENCRYPT) CSR generated successfully [ OK ]
2024-12-10T22:07:03.703Z [MASTER] info: (LETSENCRYPT) Requesting certificate from Let's Encrypt...
2024-12-10T22:07:03.704Z [MASTER] info: (LETSENCRYPT) Setting HTTP challenge for wiki.mywebsite.com: [ READY ]
2024-12-10T22:07:03.704Z [MASTER] info: (LETSENCRYPT) Waiting for challenge to complete...
2024-12-10T22:07:08.708Z [MASTER] info: (LETSENCRYPT) Received valid challenge request. [ ACCEPTED ]
2024-12-10T22:07:08.711Z [MASTER] info: (LETSENCRYPT) Removing HTTP challenge: [ OK ]
2024-12-10T22:07:14.156Z [MASTER] info: (LETSENCRYPT) Removing HTTP challenge: [ OK ]
2024-12-10T22:07:15.419Z [MASTER] info: (LETSENCRYPT) New certificate received successfully: [ COMPLETED ]
2024-12-10T22:07:15.427Z [MASTER] info: (LETSENCRYPT) Using existing certificate for wiki.mywebsite.com, expires on 2024-12-17T22:07:08Z: [ OK ]
```

# Upgrade

This image comes with the Wiki.js Update Companion. This feature automates the upgrade process when a new version is available.
Expand All @@ -113,4 +163,4 @@ When a new version is available, you'll be notified in the **Administration Area
1. Wait for the process to complete.
1. You should now be on the latest version. It's that simple!

![](https://static.requarks.io/logo/digitalocean-alt.svg){.align-abstopright}
![](https://static.requarks.io/logo/digitalocean-alt.svg){.align-abstopright}