Prerequisites¶
Everything you need installed and configured before working with MIP.
Package Manager (Chocolatey)¶
Chocolatey makes it easy to install and manage tools on Windows. Check if it is already installed:
If not found, open PowerShell as Administrator and run:
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
Restart PowerShell, then verify:
Node.js & npm¶
The backend is a NestJS (TypeScript) application. Check if already installed:
If not found:
Restart PowerShell, then verify:
| Tool | Recommended Version |
|---|---|
| Node.js | v24.13.1 or later |
| npm | 11.8.0 or later |
Unreal Engine (Source Build)¶
A source build is required for both client and server packaging. The Epic Games Launcher version cannot be used to produce builds that connect to a Linux dedicated server.
Launcher version limitation
The Launcher version of UE cannot package a Linux dedicated server, and clients packaged with it will not be compatible with a server built from source. You must use the source build for both.
- Get access to the Epic Games / UnrealEngine GitHub repository by linking your Epic account.
- Clone or download UE 5.7.4 source:
- Download zip: 5.7.4-release.zip
- Or clone the tag:
- Run
Setup.batthenGenerateProjectFiles.batand build in Development Editor configuration.
Info
The source build unlocks the <ProjectName>Server target and the Linux cross-compilation pipeline. Without it, the Scripts → SERVER buttons in the MIP Control Panel will not work.
Linux Cross-Compilation Toolchain¶
To package a Linux dedicated server from Windows, you need the cross-compilation toolchain.
- Download the toolchain from the UE Cross-Compile docs.
- Set the environment variable
LINUX_MULTIARCH_ROOTto the toolchain install path. - In the UE Editor, verify under Project Settings > Platforms > Linux that the toolchain is detected.
Warning
This is required. Dedicated servers run as Linux containers in Minikube/Kubernetes, so you must be able to cross-compile Linux server binaries from Windows.
Docker¶
Docker is used to run Redis and MongoDB locally for the backend. Check if already installed:
If not found, install Docker Desktop via Chocolatey:
Restart your PC, then verify:
Warning
Make sure Docker Desktop is running before executing docker compose up -d. You can configure it to start on login in Docker Desktop settings.
Git Bash¶
Required to run the .sh scripts in MIPScripts (setup, kubeconfig merge, token generation, etc.). Comes bundled with Git for Windows. Check if already installed:
If not found:
Open a new terminal, then verify:
Python 3¶
Required to run the MIP Control Panel (mip_control_panel.py). Check if already installed:
If that works, you are done. If not:
Open a new terminal after install, then verify.
openssl¶
Required to generate RS256 JWT key pairs for the backend (via the Gen RS256 Keys button in the Control Panel).
If not found:
Open a new terminal after install, then verify.
MIP Control Panel Setup¶
With all tools installed, run the one-time setup script to configure the Control Panel with your machine-specific paths and GitLab registry URLs:
Then launch the Control Panel to verify:
See MIP Control Panel for the full walkthrough of what setup.sh configures and how the Control Panel works.