Running the application

This guide will walk you through running Kudoo locally. If you’re interested in running Kudoo in production please look at Deployments


You’ll need to have the following running on your local machine


Please note We will always use the long term release supported version of Node. Currently this is 12.

We’d suggest using a Node Version Manager in order to manage your Node versions.

For non windows users NVM or if you’re using Windows then please use NVM-Windows


Please note Docker for Windows is still pretty new and not an ideal developer experience. You can get it running, but we’ve run into multiple performance issues running on pretty high specced out laptops.

Also please ensure that you have Docker compose installed locally.

Postgres or MySQL

We support both Postgres and MySQL. This is because under the hood we use Prisma. We have some concerns about using Prisma in the long term, so if you’d like to future proof your application, we recommend using Postgres.

Please create a new database to be used for Kudoo.

Third party services

The Kudoo application also sends emails and saves pdf documents to cloud storage.

For emails we currently only support SendGrid. If you’d like add support for Mailgun or an alternative please submit a pull request.

For cloud storage we use Amazon S3 to store files. If you’d like to add support for Azureor Google Cloud please submit a pull request.

Australian Healthcare Identifiers

We also have a REST api for Australian Heatlhcare Identifiers. If you are developing an Australian Health application, please see the repository for setting up a local development environment.


You will now need to setup your environmental variables.

This consists of three steps:

  • Adjusting the docker compose file
  • Adjusting the frontend environmental variables
  • Adjusting the server environmental variables

Docker compose

Firstly you’ll need to adjust the server.yml docker compose file located under ./server/scrips/server.yml.

Add the following credentials:

  • database
  • user
  • password

You can now test to see whether it’s working by running docker-compose -f server.yml up in the scripts directory. You should see a success log similar to the one below.


Cancel the process and restart it in as a daemon docker-compose -f server.yml up -d

Frontend credentials

Navigate to the frontend folder andthen copy the env.sample file to two new files:

  • .env
  • .env.development

And then configure the variables.

Here’s an example config


Server credentials

Navigate to the server folder and then copy the env.sample file to two new files:

  • .env
  • .env.development

And then configure the variables.

You will need to configure Stripe credentials in order to take payments. If you aren’t a commercial entity, please raise an issue on Github and we will fix this requirement.


There is a bash script you can use but it’s still WIP. So to get the local environment running locally follow these steps:

docker-compose -f server.yml up -d
cd server
npm run start
cd ../frontend
npm install
npm run start