Clone a repo and launch a micro from scratch

Goal: start from a micro you haven’t even cloned and end up with it running locally.

1. Link your Git account (if the repo is private)

In Settings → Git connections, add a connection for the host (GitHub, GitLab or another) with a read-only token. MicroLab will use it to clone private repos from that host. Not needed for public repos.

2. Import the micro from Git

In the Micros section, use Import micro from Git: paste the repository URL and choose the destination folder. MicroLab clones the repo and autodetects the micro (stack, ports, infra, dependencies) in one step, showing you what was detected before saving it.

If you already have the repo on disk, skip this and use + Add micro choosing its folder.

3. Check the environment

Create a scenario with that micro (or add it to one) and open the Environment check: it will tell you if you’re missing a tool, credential or Docker before launching. Fix the failures it marks.

4. Launch

With Docker started, click ▶ Start. If the micro calls other cores you don’t have or don’t want to launch, resolve those dependencies as mock or cloud.

See also

• Your first scenario in 5 minutes
• Micros section