Installation

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

Free — runs in your browser. Nothing to install; launch at /nano/.

Optional install + start the tunnel

npm install -g vyomi-tunnel   # any OS with Node 18+
vyomi-tunnel                  # relay on http://127.0.0.1:8090

Optional — Nano runs fully in your browser without this.
REQUIRED only to reach WASM RDS from external apps: the in-browser
Postgres is exposed to host apps solely over the tunnel, via the RDS
Data API. No global install:  npx vyomi-tunnel

npm install -g vyomi-tunnel   # any OS with Node 18+
vyomi-tunnel                  # relay on http://127.0.0.1:8090

Optional install + start the tunnel

brew install vyomi-cloud/tap/vyomi-tunnel   # Homebrew tap — coming soon
vyomi-tunnel

Optional — Nano runs fully in your browser without this.
REQUIRED only for external access to WASM RDS (via the RDS Data API).

brew install vyomi-cloud/tap/vyomi-tunnel   # Homebrew tap — coming soon
vyomi-tunnel

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

docker --version      # verify Docker is running

macOS / Windows: install Docker Desktop — https://docker.com/products/docker-desktop
Linux: install Docker Engine — https://docs.docker.com/engine/install/

docker --version      # verify Docker is running

Step 2 Get the compose file + start

curl -fsSL https://raw.githubusercontent.com/vyomi-cloud/appliance/main/docker-compose.cloudlite.yml -o docker-compose.yml
docker compose up -d

curl -fsSL https://raw.githubusercontent.com/vyomi-cloud/appliance/main/docker-compose.cloudlite.yml -o docker-compose.yml
docker compose up -d

Step 3 Open the console

Wait ~30s for the simulator to pull + boot, then open:
  http://localhost:9000
Pro tier: launch an EC2 instance in the console, then
  ssh ubuntu@<instance-ip>   (key is injected at launch)

Day-2 stop / update

docker compose down            # stop
docker compose pull && docker compose up -d   # update to latest

docker compose down            # stop
docker compose pull && docker compose up -d   # update to latest

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.8.1 (pinned, bypasses the tap)

curl -fsSL https://github.com/vyomi-cloud/appliance/releases/download/v2.8.1/cloud-learn-2.8.1.tar.gz | tar -xz
cd cloud-learn-2.8.1
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.8.1/cloud-learn-2.8.1.tar.gz | tar -xz
cd cloud-learn-2.8.1
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

Optional install + start the tunnel

npm install -g vyomi-tunnel   # any OS with Node 18+
vyomi-tunnel                  # relay on http://127.0.0.1:8090

Optional — Nano runs fully in your browser without this.
REQUIRED only to reach WASM RDS from external apps: the in-browser
Postgres is exposed to host apps solely over the tunnel, via the RDS
Data API. No global install:  npx vyomi-tunnel

npm install -g vyomi-tunnel   # any OS with Node 18+
vyomi-tunnel                  # relay on http://127.0.0.1:8090

Optional install + start the tunnel

brew install vyomi-cloud/tap/vyomi-tunnel   # Homebrew tap — coming soon
vyomi-tunnel

Optional — Nano runs fully in your browser without this.
REQUIRED only for external access to WASM RDS (via the RDS Data API).

brew install vyomi-cloud/tap/vyomi-tunnel   # Homebrew tap — coming soon
vyomi-tunnel

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

docker --version      # verify Docker is running

macOS / Windows: install Docker Desktop — https://docker.com/products/docker-desktop
Linux: install Docker Engine — https://docs.docker.com/engine/install/

docker --version      # verify Docker is running

Step 2 Get the compose file + start

curl -fsSL https://raw.githubusercontent.com/vyomi-cloud/appliance/main/docker-compose.cloudlite.yml -o docker-compose.yml
docker compose up -d

curl -fsSL https://raw.githubusercontent.com/vyomi-cloud/appliance/main/docker-compose.cloudlite.yml -o docker-compose.yml
docker compose up -d

Step 3 Open the console

Wait ~30s for the simulator to pull + boot, then open:
  http://localhost:9000
Pro tier: launch an EC2 instance in the console, then
  ssh ubuntu@<instance-ip>   (key is injected at launch)

Day-2 stop / update

docker compose down            # stop
docker compose pull && docker compose up -d   # update to latest

docker compose down            # stop
docker compose pull && docker compose up -d   # update to latest

Step 1 Install vyomi

wget https://github.com/vyomi-cloud/appliance/releases/download/v2.8.1/cloud-learn_2.8.1_all.deb
sudo apt install -y ./cloud-learn_2.8.1_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.8.1/cloud-learn_2.8.1_all.deb
sudo apt install -y ./cloud-learn_2.8.1_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

Step 1 Install vyomi

wget https://github.com/vyomi-cloud/appliance/releases/download/v2.8.1/cloud-learn-2.8.1-1.noarch.rpm
sudo dnf install -y ./cloud-learn-2.8.1-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.8.1/cloud-learn-2.8.1-1.noarch.rpm
sudo dnf install -y ./cloud-learn-2.8.1-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 install + start the tunnel

npm install -g vyomi-tunnel   # any OS with Node 18+
vyomi-tunnel                  # relay on http://127.0.0.1:8090

Optional — Nano runs fully in your browser without this.
REQUIRED only to reach WASM RDS from external apps: the in-browser
Postgres is exposed to host apps solely over the tunnel, via the RDS
Data API. No global install:  npx vyomi-tunnel

npm install -g vyomi-tunnel   # any OS with Node 18+
vyomi-tunnel                  # relay on http://127.0.0.1:8090

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

docker --version      # verify Docker is running

macOS / Windows: install Docker Desktop — https://docker.com/products/docker-desktop
Linux: install Docker Engine — https://docs.docker.com/engine/install/

docker --version      # verify Docker is running

Step 2 Get the compose file + start

curl -fsSL https://raw.githubusercontent.com/vyomi-cloud/appliance/main/docker-compose.cloudlite.yml -o docker-compose.yml
docker compose up -d

curl -fsSL https://raw.githubusercontent.com/vyomi-cloud/appliance/main/docker-compose.cloudlite.yml -o docker-compose.yml
docker compose up -d

Step 3 Open the console

Wait ~30s for the simulator to pull + boot, then open:
  http://localhost:9000
Pro tier: launch an EC2 instance in the console, then
  ssh ubuntu@<instance-ip>   (key is injected at launch)

Day-2 stop / update

docker compose down            # stop
docker compose pull && docker compose up -d   # update to latest

docker compose down            # stop
docker compose pull && docker compose up -d   # update to latest

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

Step 1 Download + run the installer

https://github.com/vyomi-cloud/appliance/releases/download/v2.8.1/cloud-learn-2.8.1-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.8.1/cloud-learn-2.8.1-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

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.8.1 via tagged manifest URL

scoop install https://raw.githubusercontent.com/vyomi-cloud/scoop-bucket/v2.8.1/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.8.1/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