Installation

Pick your platform below and copy one command — the vyomi launcher boots the full appliance inside Multipass.

Step 1 Install Homebrew (one-time, if you don't have it)

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

After install, brew will print 2 lines to add to your shell rc.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Step 2 Install vyomi v2.1.0 (pinned, bypasses the tap)

curl -fsSL https://github.com/vyomi-cloud/appliance/releases/download/v2.1.0/cloud-learn-2.1.0.tar.gz | tar -xz
cd cloud-learn-2.1.0
sudo install -m 0555 scripts/cloud-learn /usr/local/bin/vyomi
sudo install -m 0555 scripts/cloud-learn /usr/local/bin/cloud-learn   # legacy alias (optional)

This release's launcher is self-contained bash — no compiler needed.

curl -fsSL https://github.com/vyomi-cloud/appliance/releases/download/v2.1.0/cloud-learn-2.1.0.tar.gz | tar -xz
cd cloud-learn-2.1.0
sudo install -m 0555 scripts/cloud-learn /usr/local/bin/vyomi
sudo install -m 0555 scripts/cloud-learn /usr/local/bin/cloud-learn   # legacy alias (optional)

Step 3 Install Multipass (one-time prerequisite)

brew install --cask multipass

(macOS will ask for your sudo password to install the .pkg.)

brew install --cask multipass

Step 4 Start the appliance

vyomi up

Boots the appliance VM (~3-5 min first time) and opens your
browser at https://localhost:9443/ with a green padlock.

vyomi up

Day-2 rollback / upgrade later

vyomi down                                # stop the appliance VM
sudo rm /usr/local/bin/vyomi /usr/local/bin/cloud-learn
brew tap vyomi-cloud/tap && brew install vyomi

To leave the pinned install for the live latest:

vyomi down                                # stop the appliance VM
sudo rm /usr/local/bin/vyomi /usr/local/bin/cloud-learn
brew tap vyomi-cloud/tap && brew install vyomi

Step 1 Install vyomi

wget https://github.com/vyomi-cloud/appliance/releases/download/v2.1.0/cloud-learn_2.1.0_all.deb
sudo apt install -y ./cloud-learn_2.1.0_all.deb

(artifact filename keeps the legacy `cloud-learn_*.deb`
 name through v2.x for back-compat; both `vyomi` and
 `cloud-learn` shims are installed to /usr/bin.)

wget https://github.com/vyomi-cloud/appliance/releases/download/v2.1.0/cloud-learn_2.1.0_all.deb
sudo apt install -y ./cloud-learn_2.1.0_all.deb

Step 2 Start the appliance

vyomi up

On first run the launcher will:
  - detect missing Multipass and offer to install it
    via `sudo snap install multipass` (snapd is
    preinstalled on Ubuntu; on Debian see note below)
  - boot the appliance VM (~3-5 min first time)
  - open your browser at https://localhost:9443/
    (green padlock via mkcert-trusted local CA)

vyomi up

Day-2 stop / upgrade

vyomi down                                # stop the appliance

Upgrade — re-run Step 1 with the new version number
(signed APT repo is in the roadmap)

vyomi down                                # stop the appliance

Optional use Docker Compose as the front door

curl -fsSL https://raw.githubusercontent.com/vyomi-cloud/appliance/main/packaging/compose-provider/docker-compose.yml -o docker-compose.yml
docker compose -p vyomi up      # → vyomi up   (boots the appliance)
docker compose -p vyomi down    # → vyomi down (stops it)

Prefer `docker compose`? Once the launcher is installed (above), it
becomes the Compose provider — `docker compose up` runs `vyomi up`,
booting the SAME appliance inside Multipass (full EC2/LXD compute).
Needs Docker on your machine.

curl -fsSL https://raw.githubusercontent.com/vyomi-cloud/appliance/main/packaging/compose-provider/docker-compose.yml -o docker-compose.yml
docker compose -p vyomi up      # → vyomi up   (boots the appliance)
docker compose -p vyomi down    # → vyomi down (stops it)

Step 1 Install vyomi

wget https://github.com/vyomi-cloud/appliance/releases/download/v2.1.0/cloud-learn-2.1.0-1.noarch.rpm
sudo dnf install -y ./cloud-learn-2.1.0-1.noarch.rpm

(artifact filename keeps the legacy `cloud-learn-*.rpm`
 name through v2.x for back-compat; both `vyomi` and
 `cloud-learn` shims are installed to /usr/bin.)

wget https://github.com/vyomi-cloud/appliance/releases/download/v2.1.0/cloud-learn-2.1.0-1.noarch.rpm
sudo dnf install -y ./cloud-learn-2.1.0-1.noarch.rpm

Step 2 Bootstrap snapd if it isn't there yet (minimal images)

sudo dnf install -y snapd
sudo systemctl enable --now snapd.socket
sudo ln -s /var/lib/snapd/snap /snap   # classic-confinement symlink

Fedora / RHEL / CentOS often ship without snapd. The launcher
will print these commands for you if Multipass install fails.
(skip this step entirely if `snap --version` already works)

sudo dnf install -y snapd
sudo systemctl enable --now snapd.socket
sudo ln -s /var/lib/snapd/snap /snap   # classic-confinement symlink

Step 3 Start the appliance

vyomi up

On first run the launcher will:
  - detect missing Multipass and run `sudo snap install multipass`
    (which is why snapd from Step 2 needs to be ready)
  - boot the appliance VM (~3-5 min first time)
  - open your browser at https://localhost:9443/
    (green padlock via mkcert-trusted local CA)

vyomi up

Optional use Docker Compose as the front door

curl -fsSL https://raw.githubusercontent.com/vyomi-cloud/appliance/main/packaging/compose-provider/docker-compose.yml -o docker-compose.yml
docker compose -p vyomi up      # → vyomi up   (boots the appliance)
docker compose -p vyomi down    # → vyomi down (stops it)

Prefer `docker compose`? Once the launcher is installed (above), it
becomes the Compose provider — `docker compose up` runs `vyomi up`,
booting the SAME appliance inside Multipass (full EC2/LXD compute).
Needs Docker on your machine.

curl -fsSL https://raw.githubusercontent.com/vyomi-cloud/appliance/main/packaging/compose-provider/docker-compose.yml -o docker-compose.yml
docker compose -p vyomi up      # → vyomi up   (boots the appliance)
docker compose -p vyomi down    # → vyomi down (stops it)

Step 1 Install vyomi

winget install Vyomi.Vyomi

winget install Vyomi.Vyomi

Step 2 Start the appliance

vyomi up

Open a NEW terminal so `vyomi` is on PATH, then:
(Optional) If `vyomi` or `multipass` isn't recognized, this
shell's PATH is stale - open a fresh PowerShell, or run once:
  $env:Path = "C:\Program Files\Multipass\bin;$env:Path"
First run auto-installs Multipass (UAC prompt), sizes the VM
to leave the host headroom, pulls the stack, then opens
http://localhost:9000/

vyomi up

Day-2 upgrade / stop

winget upgrade Vyomi.Vyomi
vyomi down

winget upgrade Vyomi.Vyomi
vyomi down

Optional use Docker Compose as the front door

curl -fsSL https://raw.githubusercontent.com/vyomi-cloud/appliance/main/packaging/compose-provider/docker-compose.yml -o docker-compose.yml
docker compose -p vyomi up      # → vyomi up   (boots the appliance)
docker compose -p vyomi down    # → vyomi down (stops it)

Prefer `docker compose`? Once the launcher is installed (above), it
becomes the Compose provider — `docker compose up` runs `vyomi up`,
booting the SAME appliance inside Multipass (full EC2/LXD compute).
Needs Docker on your machine.

curl -fsSL https://raw.githubusercontent.com/vyomi-cloud/appliance/main/packaging/compose-provider/docker-compose.yml -o docker-compose.yml
docker compose -p vyomi up      # → vyomi up   (boots the appliance)
docker compose -p vyomi down    # → vyomi down (stops it)

Step 1 Download + run the installer

https://github.com/vyomi-cloud/appliance/releases/download/v2.1.0/cloud-learn-2.1.0-x64.msi

Download, then double-click. SmartScreen (unsigned):
  More info -> Run anyway. Accept the UAC prompt.

https://github.com/vyomi-cloud/appliance/releases/download/v2.1.0/cloud-learn-2.1.0-x64.msi

Step 2 Start the appliance

vyomi up

Open a NEW terminal so `vyomi` is on PATH, then:
(Optional) If `vyomi` or `multipass` isn't recognized, this
shell's PATH is stale - open a fresh PowerShell, or run once:
  $env:Path = "C:\Program Files\Multipass\bin;$env:Path"
First run auto-installs Multipass (UAC), sizes the VM to your
RAM, pulls the stack, and opens http://localhost:9000/

vyomi up

Day-2 upgrade / stop

vyomi down

Re-download the new MSI from the latest release and run it,
or `winget upgrade Vyomi.Vyomi` once winget is live.

vyomi down

Optional use Docker Compose as the front door

curl -fsSL https://raw.githubusercontent.com/vyomi-cloud/appliance/main/packaging/compose-provider/docker-compose.yml -o docker-compose.yml
docker compose -p vyomi up      # → vyomi up   (boots the appliance)
docker compose -p vyomi down    # → vyomi down (stops it)

Prefer `docker compose`? Once the launcher is installed (above), it
becomes the Compose provider — `docker compose up` runs `vyomi up`,
booting the SAME appliance inside Multipass (full EC2/LXD compute).
Needs Docker on your machine.

curl -fsSL https://raw.githubusercontent.com/vyomi-cloud/appliance/main/packaging/compose-provider/docker-compose.yml -o docker-compose.yml
docker compose -p vyomi up      # → vyomi up   (boots the appliance)
docker compose -p vyomi down    # → vyomi down (stops it)

Step 1 Install Scoop (one-time, if you don't have it)

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex

Run in PowerShell (not cmd.exe):

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex

Step 2 Install vyomi v2.1.0 via tagged manifest URL

scoop install https://raw.githubusercontent.com/vyomi-cloud/scoop-bucket/v2.1.0/bucket/vyomi.json

The scoop-bucket repo tags every appliance release as v<ver>.

scoop install https://raw.githubusercontent.com/vyomi-cloud/scoop-bucket/v2.1.0/bucket/vyomi.json

Step 3 Start the appliance

vyomi up

On first run the launcher will offer to install Multipass via
`winget install Canonical.Multipass`.

vyomi up

Day-2 rollback / upgrade later

vyomi down                                # stop the appliance VM
scoop uninstall vyomi                     # remove pinned
scoop bucket add vyomi https://github.com/vyomi-cloud/scoop-bucket
scoop install vyomi                       # back to live latest

vyomi down                                # stop the appliance VM
scoop uninstall vyomi                     # remove pinned
scoop bucket add vyomi https://github.com/vyomi-cloud/scoop-bucket
scoop install vyomi                       # back to live latest