Installation¶

vmup ships as a single static binary for macOS, Linux, and Windows. The install scripts download the latest release, verify your platform, and put the binary on your PATH.

macOS / LinuxWindows (PowerShell)

curl -fsSL https://raw.githubusercontent.com/vindhyadatascience/vmup/main/install.sh | sh

The script detects your OS and architecture (Intel or Apple Silicon / arm64) and installs to /usr/local/bin when writable, falling back to ~/.local/bin. If it falls back, it warns when ~/.local/bin is not on your PATH.

macOS Gatekeeper

Binaries installed via the script run as-is. If you instead download a release archive from a browser, macOS may flag the binary as from an unidentified developer; clear the quarantine flag with xattr -d com.apple.quarantine ./vmup (or right-click the binary in Finder → Open).

irm https://raw.githubusercontent.com/vindhyadatascience/vmup/main/install.ps1 | iex

The script installs to %LOCALAPPDATA%\vmup and adds that directory to your user PATH. Open a new terminal afterwards for the PATH change to take effect.

Verify the install¶

vmup

You should see the vmup menu. Press Q to quit.

Manual download¶

Release archives are attached to each GitHub release and named vmup_<os>_<arch>.tar.gz:

Platform	Archive
macOS (Apple Silicon)	`vmup_darwin_arm64.tar.gz`
macOS (Intel)	`vmup_darwin_amd64.tar.gz`
Linux (x86_64)	`vmup_linux_amd64.tar.gz`
Linux (arm64)	`vmup_linux_arm64.tar.gz`
Windows (x86_64)	`vmup_windows_amd64.tar.gz`

Extract the archive and place the vmup binary anywhere on your PATH.

From source¶

Requires Go:

git clone https://github.com/vindhyadatascience/vmup.git
cd vmup
make build
./vmup

Or make run to build and launch in one step.

Next: launch your first VM.