Skip to main content

Installation Guide

Follow this guide to install MijnBureau on your Kubernetes cluster. Ensure you are connected to a Kubernetes cluster before proceeding.


Verify Kubernetes Connection

Check which Kubernetes cluster you are connected to by running:

kubectl config current-context

Set Master Password

Set the environment variable for the master password to enable deterministic secret generation:

export MIJNBUREAU_MASTER_PASSWORD="your-very-secure-password"
Password Security

This password is used to generate most application secrets. Use a strong password and store it securely, as it will be required for future operations.


Configure Additional Variables

By default, MijnBureau does not create a Kubernetes namespace if it does not exist. You can enable automatic namespace creation by setting the following variable:

export MIJNBUREAU_CREATE_NAMESPACES=true

Deploy MijnBureau

Prerequisites

Install and prepare Helmfile and Helm. Refer to their respective documentation for installation instructions:

Once installed, initialize Helmfile:

helmfile init

Installation

To deploy MijnBureau to your Kubernetes cluster, execute the following command:

helmfile -e <environment> apply

Replace <environment> with the desired environment, such as demo or production. If you do not specify the -e <environment> option, MijnBureau will use the default environment.

Inspect Installation

If you want to inspect the installation without deploying, use the following command:

helmfile -e <environment> template

Additional Helmfile Commands

Helmfile provides many additional commands for managing your deployment. Refer to the Helmfile CLI Reference for more details.