Detecting your OS… ↓

Install Vyomi

Pick the path that matches your platform. Every one lands on the same simulator running at http://localhost:9000.

🐳 Docker Compose Stable

Already have Docker Desktop? Pull the published docker-compose.yml and run it directly. No Multipass needed; the stack runs in your host Docker daemon.

Fetch compose + start the stack
mkdir -p ~/.cloudlearn && cd ~/.cloudlearn
curl -O https://raw.githubusercontent.com/sudhirkumarganti/cloud-learn/main/docker-compose.yml
docker compose up -d
Open the simulator
open http://localhost:9000
Bring up ALL backends eagerly (skip lazy provisioning)
docker compose --profile full up -d
Stop / upgrade
docker compose down               # stop
docker compose pull && up -d     # upgrade to latest image
Note: Default boot starts 4 services; the other 6 (MinIO, Vault, NATS, DDB-local, ElasticMQ, MySQL) lazy-provision on first use. The simulator container mounts /var/run/docker.sock so it can manage the sibling backend containers.
🍺 Homebrew ★ Recommended Stable

Native package — installs the cloud-learn launcher CLI to PATH. `cloud-learn up` boots a Multipass VM and runs the simulator inside.

Install Multipass first (one-time)
brew install --cask multipass
Install Vyomi
brew tap sudhirkumarganti/tap
brew install cloud-learn
Start the appliance
cloud-learn up
# follow the URL the launcher prints, e.g. http://192.168.x.x:9000
Upgrade later
brew upgrade cloud-learn
Note: Multipass is the only host-side dependency — it provides the VM that runs the simulator. The simulator's own Docker stack runs INSIDE that VM, not on your Mac/Linux.
🐳 Docker Compose Stable

Already have Docker Desktop? Pull the published docker-compose.yml and run it directly. No Multipass needed; the stack runs in your host Docker daemon.

Fetch compose + start the stack
mkdir -p ~/.cloudlearn && cd ~/.cloudlearn
curl -O https://raw.githubusercontent.com/sudhirkumarganti/cloud-learn/main/docker-compose.yml
docker compose up -d
Open the simulator
open http://localhost:9000
Bring up ALL backends eagerly (skip lazy provisioning)
docker compose --profile full up -d
Stop / upgrade
docker compose down               # stop
docker compose pull && up -d     # upgrade to latest image
Note: Default boot starts 4 services; the other 6 (MinIO, Vault, NATS, DDB-local, ElasticMQ, MySQL) lazy-provision on first use. The simulator container mounts /var/run/docker.sock so it can manage the sibling backend containers.
🍺 Homebrew ★ Recommended Stable

Native package — installs the cloud-learn launcher CLI to PATH. `cloud-learn up` boots a Multipass VM and runs the simulator inside.

Install Multipass first (one-time)
brew install --cask multipass
Install Vyomi
brew tap sudhirkumarganti/tap
brew install cloud-learn
Start the appliance
cloud-learn up
# follow the URL the launcher prints, e.g. http://192.168.x.x:9000
Upgrade later
brew upgrade cloud-learn
Note: Multipass is the only host-side dependency — it provides the VM that runs the simulator. The simulator's own Docker stack runs INSIDE that VM, not on your Mac/Linux.
🐧 Debian / Ubuntu (.deb) Stable

Direct .deb download from GitHub Releases. Installs the cloud-learn launcher CLI to /usr/bin/cloud-learn.

Install Multipass first (one-time)
sudo snap install multipass
# or: sudo apt install multipass  (Ubuntu 22.04+)
Install Vyomi
wget https://github.com/sudhirkumarganti/cloud-learn/releases/download/v0.1.0/cloud-learn_0.1.0_all.deb
sudo apt install ./cloud-learn_0.1.0_all.deb
Start the appliance
cloud-learn up
Note: A signed APT repo is in the roadmap — for now, repeat the wget on each release.
🐧 Fedora / RHEL (.rpm) Stable

Direct .rpm download from GitHub Releases. Same launcher as the .deb, installed via dnf.

Install Multipass first (one-time)
sudo snap install multipass
# Snap is the only supported Multipass distribution on Fedora/RHEL today.
Install Vyomi
wget https://github.com/sudhirkumarganti/cloud-learn/releases/download/v0.1.0/cloud-learn-0.1.0-1.noarch.rpm
sudo dnf install ./cloud-learn-0.1.0-1.noarch.rpm
Start the appliance
cloud-learn up
Note: A signed yum/dnf repo is in the roadmap.
🐌 Snap Coming soon

Sandboxed Linux app from the Snap Store. Pipeline shipped end-to-end; classic confinement gating final publish.

Once classic confinement is approved
sudo snap install cloud-learn --classic
Note: Snap was successfully built + uploaded to the Snap Store on v0.1.0. Classic confinement (needed because the launcher invokes Multipass on the host) requires manual approval from Snapcraft — review queue at https://forum.snapcraft.io/c/store-requests/classic-confinement/26 — typically takes 1–4 weeks. Pipeline is one-line dispatch once approved.
🐳 Docker Compose Stable

Already have Docker Desktop? Pull the published docker-compose.yml and run it directly. No Multipass needed; the stack runs in your host Docker daemon.

Fetch compose + start the stack
mkdir -p ~/.cloudlearn && cd ~/.cloudlearn
curl -O https://raw.githubusercontent.com/sudhirkumarganti/cloud-learn/main/docker-compose.yml
docker compose up -d
Open the simulator
open http://localhost:9000
Bring up ALL backends eagerly (skip lazy provisioning)
docker compose --profile full up -d
Stop / upgrade
docker compose down               # stop
docker compose pull && up -d     # upgrade to latest image
Note: Default boot starts 4 services; the other 6 (MinIO, Vault, NATS, DDB-local, ElasticMQ, MySQL) lazy-provision on first use. The simulator container mounts /var/run/docker.sock so it can manage the sibling backend containers.
🪟 winget Coming soon

Native Windows package via winget. Coming once we ship a signed MSI installer.

Install Multipass first (one-time)
winget install Canonical.Multipass
When available
winget install CloudLearn.CloudLearn
cloud-learn up
Note: Coming soon — waiting on signed MSI build.
🪟 Scoop ★ Recommended Stable

The Brew of Windows. Single manifest, no review queue, no MSI. Installs the cloud-learn launcher and pulls Multipass automatically.

Install Scoop (one-time, if you don't have it)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex
Add the Vyomi bucket + install
scoop bucket add cloudlearn https://github.com/sudhirkumarganti/scoop-bucket
scoop install cloud-learn
Start the appliance
cloud-learn up
# follow the URL the launcher prints, e.g. http://192.168.x.x:9000
Upgrade later
scoop update cloud-learn
Note: Scoop's `depends` block pulls in Multipass automatically. You still need Hyper-V enabled (Win10/11 Pro/Enterprise) OR VirtualBox installed for Multipass to run the VM.

After install

  1. Run cloud-learn up (or docker compose up -d) to start the appliance.
  2. Open http://localhost:9000 in your browser.
  3. Sign in here on the portal to pick a plan — Free tier covers 10 service categories across all 3 clouds.
  4. Activate the appliance with your license JWT or via Sign in with Vyomi on the appliance's /pricing page.
  5. Browse the API reference or jump straight to what's possible.