Deploy Wiki.js on Northflank

Wiki.js is a free powerful and extensible open-source wiki software that makes writing documentation a joy through its beautiful and intuitive interface. This guide will show you how to deploy Wiki.js on Northflank using their public Docker image and a Postgres database to store data across restarts.

1. Create a new Postgres addon.

   • Choose the storage size according to your needs, it can be increased later if your storage needs change.

   

2. Create a new secret group.

   1. Add the following keys and assign them the respective values.

   Key	Value
   HA_ACTIVE	true
   DB_TYPE	postgres

   2. Link the following variables from the Postgres addon created in the previous step and assign them the respective aliases.

   Variable name	Alias
   HOST	DB_HOST
   PORT	DB_PORT
   USERNAME	DB_USER
   PASSWORD	DB_PASS
   DATABASE	DB_NAME
   TLS_ENABLED	DB_SSL

   

3. Create a new deployment service with the following configuration:

   1. Under deployment, select external image with the path requarks/wiki:latest.

   2. Under resources, it’s recommended to use plan nf-compute-50 or larger to ensure appropriate app performance.

   • Port 3000 will automatically be detected from the image manifest and will be exposed with the HTTP protocol.

     

4. Wait for the Wiki.js instance to start up and open the web interface by clicking on the link in the top right corner of your service.

   • It will take approximately a minute for the Wiki.js instance to start up.

5. On the web interface you will be prompted to enter some information to complete the Wiki.js installation process. Once you have completed the installation process, you will be able to start configuring and adding content to your wiki.

   

If you encounter any issues while following this guide we're happy to assist you with your Wiki.js deployment at support@northflank.com. At Northflank we also have dedicated support plans for business customers.