WikiJS installation on OpenShift / OKD 4

1. Create a project:

Or go to https://console-openshift-console.apps-crc.testing/k8s/cluster/projects and click Create Project and name it wikijs

2. Install Crunchy Postgres for the Kubernetes operator from OperatorHub or follow the instructions here:

https://access.crunchydata.com/documentation/postgres-operator/v5/quickstart/

Select all namespaces if you want it to be used in more than one, otherwise use the wikijs namespace we created earlier

3. Install the postgres DB as follows and ensure that your oc command uses the correct context. Change the values if needed - currently it is 20GB.

4. You should now have a PostgresCluster CR under the installed operators tab:

You should be able to connect from the local machine with psql like this (make sure psql is installed):

You should get a shell that shows the connection is using TLS, which is the default with this operator.

5. For me, it did not work to have WikiJS connected to PostgreSQL with SSL, I needed to add the CA certificate as described in the documentation:

(DB_SLL_CA - The database CA certificate content, as a single line string (without spaces or new lines), without prefix and suffix lines. (optional, requires 2.3+))

This is stored in the pgo-root-cacert secret, run the script to get it in the correct format:

It will provide something similar to:

Add this to deploymentConfig.yaml, excerpt:

Now we are ready to implement it.

6. The deployment file contains a reference to the docker image created by the author of the said reference. As mentioned, this can be built from the included Dockerfile.

For convenience, we can use that image; to use your own, build the image and tag it:
docker build -t yourusername/repositoryname .

I used Docker Hub :

then push it to your chosen registry and update the reference in the deployment file
more info : https://docs.docker.com/engine/reference/commandline/push/

Now apply the deployment:

7. Now that the app is deployed, we can add a service and a route to expose it. Update the route file with your server URL:

You should now have the application running and exposed on the route, you can now complete the setup.

Enjoy WikiJS!

Optional
If you have an existing collection of Markdown files (MD) it can be useful to add them to the wiki. More information on how to set this up when it is stored in git can be found here.
The files will be indexed and added to WikiJS and can be edited directly with the Markdown editor. As a bonus, WikiJS has a diagram plugin that makes it really easy to add draw.io-based diagrams directly in the documents.

It is also quite easy to set up OpenID connect with for example Keycloak.
Under administration, go to authentication, add strategy and choose Keycloak.
Create a client in Keycloak and fill in the requirements present.
Disable the guest user if you don't want it to be public, see:
https://docs.requarks.io/groups (Private Wiki)

Binero Group delivers OKD on top of Binero cloud and also a fully supported Red Hat OpenShift Container Platform as a hosted or fully managed solution, in Swedish data centre, GDPR-compliant.

Try Binero cloud and contact us if you have any questions, we are happy to help!

Create account in Binero cloud