¶ Overview
The AWS Marketplace Wiki.js image is a pre-configured environment, made by the developers of Wiki.js, containing everything you need to get started with Wiki.js.
¶ Image Specifications
Ubuntu 18.04 LTS with the following software pre-installed:
- Docker
- PostgreSQL 11 (dockerized)
- Wiki.js 2.x (dockerized, accessible via port 80)
- Wiki.js Update Companion (dockerized)
- OpenSSH with UFW Firewall preconfigured for SSH, HTTP and HTTPS
¶ Instance Type
Wiki.js requires at least the t3.micro instance size. The t3.nano instance type is not supported.
However, for best performance, we recommend using at least the t3.small or preferrably the c5.large instance size. Wiki.js use background processes for CPU intensive tasks (e.g. page rendering). Therefore, having at least 2 dedicated CPU cores will results in improved performance for such tasks.
¶ Getting Started
- From the Wiki.js Product Page on AWS Marketplace, click the Continue to subscribe button located at the top of the page.
- Follow the on-screen instructions to launch an instance.
- Once the instance is running, go to the instance details in the AWS Management Console.
- Copy the Public DNS endpoint for your instance.
- In a new browser tab, navigate to http://YOUR-PUBLIC-DNS (replace with your Public DNS endpoint or IP)
It can take several minutes before the server starts accepting requests. Various services must initialize for the first time before you'll be able to access your wiki. If it doesn't load on first attempt, wait 5 minutes and try again.
- A setup screen for Wiki.js should appear. Enter the desired email address and password for the administrator account.
- Enter the full URL to your wiki, without the trailing slash. It's recommended to point a sub-domain / domain to your public IP (e.g. wiki.example.com). If you don't have a domain setup yet, you can use your public DNS endpoint or IP as the URL (e.g. http://xx.xx.xx.xx). This can be changed later in the Administration Area (under the General section).
- Click on Install to complete the installation. You'll automatically be redirected to the login page once completed. Enter the email and password for the administrator account you entered earlier.
¶ Automatic HTTPS with Let's Encrypt
You must complete the setup wizard (see Getting Started) BEFORE enabling Let's Encrypt!
- Create an A record on your domain registrar to point a domain / sub-domain (e.g. wiki.example.com) to your EC2 instance public IP.
- Make sure you're able to load your wiki using that domain / sub-domain on HTTP (e.g. http://wiki.example.com).
- Connect to your EC2 instance via SSH.
- Stop and remove the existing wiki container (no data will be lost) by running the commands below:
docker stop wiki
docker rm wiki
- Run the following command by replacing the
wiki.example.comand[email protected]values with your own domain / sub-domain and the email address of your wiki administrator:
docker create --name=wiki -e LETSENCRYPT_DOMAIN=wiki.example.com -e [email protected] -e SSL_ACTIVE=1 -e DB_TYPE=postgres -e DB_HOST=db -e DB_PORT=5432 -e DB_PASS_FILE=/etc/wiki/.db-secret -v /etc/wiki/.db-secret:/etc/wiki/.db-secret:ro -e DB_USER=wiki -e DB_NAME=wiki -e UPGRADE_COMPANION=1 --restart=unless-stopped -h wiki --network=wikinet -p 80:3000 -p 443:3443 requarks/wiki:2
- Start the container by running the command:
docker start wiki
- Wait for the container to start and the Let's Encrypt provisioning process to complete. You can optionaly view the container logs by running the command:
docker logs wiki
The process will be completed once you see the following lines in the logs:
(LETSENCRYPT) New certifiate received successfully: [ COMPLETED ]
HTTPS Server on port: [ 3443 ]
HTTPS Server: [ RUNNING ]
- Load your wiki in your web browser using HTTPS (e.g. https://wiki.example.com). Your wiki is now accepting HTTPS requests using a free Let's Encrypt certificate!
¶ Automatic HTTP to HTTPS Redirect
By default, requests made to the HTTP port will not be redirect to HTTPS. You can enable this option using these instructions:
- Navigate to the Administration Area by clicking on your avatar at the top-right corner of the page.
- From the left navigation menu, click on SSL.
- Next to the
Redirect HTTP requests to HTTPSsection, click on TURN ON to enable HTTP to HTTPS redirection. - Any requests made to the HTTP port will now automatically redirect to HTTPS!
¶ Renew the Certificate
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:
docker restart wiki
The renewal process will run automatically during initialization.
¶ Upgrade
This image comes with the Wiki.js Update Companion. This feature automates the upgrade process when a new version is available.
When a new version is available, you'll be notified in the Administration Area. To perform the upgrade, follow these simple instructions:
- Go to the System Info section and click the Perform Upgrade button.
- Wait for the process to complete.
- You should now be on the latest version. It's that simple!
