Local Development Environment

Pre Flight Checks

Run dev-pre-flight-checks.sh command line tool with

curl -L https://codeberg.org/headshed/infctl-cli/raw/branch/main/scripts/dev-pre-flight-checks.sh | bash

Alternatively, download https://codeberg.org/headshed/infctl-cli/raw/branch/main/scripts/dev-pre-flight-checks.sh locally, check over what it does, chmod +x dev-pre-flight-checks.sh and run ./dev-pre-flight-checks.

the following executables are checked to be in your $PATH:

“infctl” “pwgen” “kubectl” “k3d” “helm” “jq” “docker” “vagrant” “git”

if any of these are missing, an MVK development environment may fail.

Note for windows users

Linux and Mac already have bash and often git installed as part of a default developer environment, however Windows may not, so for MVK, we can use Git Bash, so check you have this installed on Windows if not already.

Windows will need jq to be installed by downloading it or installing with winget install jqlang.jq.

Use Git Bash from here on to run infctl commands as they will require for there to be a bash shell to run any of its plugins.

Install Pre-Requisites

infctl - see quick start

pwgen, jq are typically available in package managers

To install pwgen or jq:

On macOS (using Homebrew):

brew install pwgen jq

On Linux (Debian/Ubuntu):

sudo apt-get update
sudo apt-get install pwgen jq

On Linux (Fedora):

sudo dnf install pwgen jq

To download kubectl, visit the official Kubernetes documentation: Install and Set Up kubectl. Follow the instructions for your operating system.

To install k3d go to k3d installation and follow their guide

To install helm got to helm install and follow their guide

Docker can be installed in a variety of ways but for most Windows and Mac users docker desktop can be an easy option

For Linux users, docker engine install is more often than not the better option.

Which ever path you take to install Docker, any of the above will work but if you are interesting in really getting to know Kubernetes, it is would be really good to go for a Linux based solution as this is typically what Kubernetes is likely to be running on in any production grade environment.

To install vagrant, visit the official Vagrant downloads page and choose the installer for your operating system.

Note: Vagrant typically requires a compatible hypervisor to manage virtual machines. The most common option is VirtualBox, which works on Windows, macOS, and Linux. You can download VirtualBox from the official site.

• On Windows, you may also use Hyper-V if available.
• On Linux, KVM is a popular alternative.

For most users, installing VirtualBox alongside Vagrant is the simplest and most widely supported setup.

Example installation on macOS (using Homebrew):

brew install --cask vagrant virtualbox

Example installation on Ubuntu/Debian:

sudo apt-get update
sudo apt-get install vagrant virtualbox

After installation, verify both are available in your $PATH by running:

vagrant --version
VBoxManage --version