The Workspace Setup

Get Ready

MVK uses a Container-based environment. This prevents “dependency hell” on your local machine.

Install Docker Host
Install the standard Docker Engine by running the docker convenient script:
Terminal window
curl -fsSL https://get.docker.com -o get-docker.sh sh get-docker.sh
Add your user to the docker group to avoid using sudo with docker commands:
Terminal window
sudo usermod -aG docker $USER
Reboot or logout/login to apply the group change.
Use Colima.
Colima can be installed with brew install colima docker then colima start.

Install WSL2 by following Microsoft’s guide.
Install Docker in the same way as Linux.
Do not use Docker Desktop unless you have no other choice.
If you have to use Docker Desktop, ensure the WSL2 backend is used and be aware to switch context between Docker Desktop and WSL2 as needed.
Install infctl
infctl can be installed with:
Terminal window
```
curl -L https://codeberg.org/headshed/infctl-cli/raw/branch/main/cmd/install.sh | bash
```
infctl is a command line tool used by MVK to orchestrate code. It makes scripted infrastructure as code simpler and easier to run, manage, and support. You can think of it as a ‘simpler pipeline’.
We will use infctl to help us deploy Kubernetes in a minimal viable configuration.
Verify Everything
Run this check. It uses the preflight engine to ensure your container environment is healthy:
Terminal window
```
infctl-preflight-checks -C
```

Clone repo

# clone the repo
mkdir -p ~/projects/mvk
cd ~/projects/mvk
git clone https://codeberg.org/headshed/infctl-cli.git
cd infctl-cli

Start dev environment

# start the docker compose environment
./dev-shell.sh

you are now shelled into a container that has the tooling needed to build Minimal Viable Kubernetes (MVK).