Install MicroLab

MicroLab is distributed as a desktop application packaged for Windows, macOS and Linux. It is not cloned or built from source: you install it from the corresponding installer.

Before installing

• Docker Desktop (or a compatible Docker daemon). MicroLab launches the common infrastructure (Kafka, Redis, PostgreSQL) and container-mode micros with Docker. You can install MicroLab without Docker, but you won’t be able to start scenarios with infrastructure or containers until you have it.
• Your micros’ repositories cloned on your machine (or clone them later from the app itself with “Import micro from Git”).

You don’t need to install Java, Node or Python in any special way: to start each micro, MicroLab uses the repo’s own wrapper (mvnw), the .venv or the binary on your PATH, just as you would by hand.

Download

From micro-lab.dev (downloads section), choose your operating system:

System	Installer
Windows	MicroLab-Setup.exe
Linux	MicroLab.AppImage (or the .deb package)
macOS	See the downloads section (during the beta it may not be packaged)

The file downloads directly. The latest version always points to the most recent one.

Install

• Windows: run MicroLab-Setup.exe and follow the wizard.
• Linux: make the AppImage executable (chmod +x MicroLab.AppImage) and open it, or install the .deb with your package manager.
• macOS: open the .dmg and drag MicroLab to Applications.

Automatic updates

MicroLab checks for updates on startup and notifies you when there is a new version (you’ll see a notice next to Settings). You can also check manually in Settings → About → Check for updates. When one is available, it downloads and installs on restart; you don’t have to go back to the website.

Next step

• First launch: sign-in, consent and diagnostics.
• Your first scenario in 5 minutes.