WikiJS installation on OpenShift / OKD 4

1. Create a project:

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

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

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

Choose all namespaces if you want it to be useable in more than one, if not use the wikijs one that we created before

3. Install the postgres DB as follows, making sure your oc command is using the right context. Change the values if needed - currently it's 20GB.

4. Now you should have a PostgresCluster CR under the tab under installed operators:

You should be able to connect from the local machine with psql like so (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 connect to PostgreSQL with SSL, I needed to add the CA cert as described in the docs:

(DB_SLL_CA - Database CA certificate content, as a single line string (without spaces or new lines), without the 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 right format:

It will give something like:

Add this to the deploymentConfig.yaml, snippet:

Now we are ready to deploy it.

6. The deployment file contains a reference to the docker image the author of the mentioned reference made. As mentioned, this can be build from the Dockerfile which is included.

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

I used docker hub :

then push it to your registry of choice 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 te expose it. Update the route file with your server URL:

You should have the application running and exposed on the route now, you can finish setting it up.

Enjoy WikiJS!

Optional
If you have an existing collection of Markdown files (MD) it can be useful to add those to the wiki. More information on how to set it up when stored in git can be found here.
The files will be indexed and added to WikiJS and can be directly edited 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's also quite easy to setup OpenID connect with for example Keycloak.
Under administration, go to authentication, add strategy and select Keycloak.
Create a client in Keycloak and fill in the required fields.
Disable the guest user if you do not 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, on Swedish datacenters, GDPR compliant.

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

Create account in Binero cloud