Operations

Download and install

mountOS ships as prebuilt binaries from a public distribution endpoint. A one-line installer downloads the right artifact for the host platform, verifies its checksum, and places it on the path. The client CLI covers macOS, Linux, and Windows. The server services ship as Linux binaries.

Quick install

macOS and Linux:

curl -fsSL https://download.mountos.sh | bash

Windows (PowerShell):

powershell

Invoke-WebRequest https://download.mountos.sh/install.ps1 -OutFile mountos.ps1; .\mountos.ps1

By default this installs the full client bundle on macOS and Windows (the GUI apps plus the mountos CLI), and the bare mountos CLI on Linux, at its latest version, auto-detecting the platform and architecture. Pass --pkg mountos-cli (-Pkg mountos-cli) for just the CLI on macOS/Windows too.

Where it comes from

Endpoint	Address	Purpose
Portal	`https://mountos.io`	Product and documentation
Distribution	`https://download.mountos.sh`	Install scripts, release archives, checksums, and manifests

Installer options

Pass options to the bash installer after --:

curl -fsSL https://download.mountos.sh | bash -s -- --pkg mountos-cli --version 1.2.3

bash flag	PowerShell flag	Meaning	Default
`--pkg NAME`	`-Pkg NAME`	Package to install	full bundle (`mountos-cli` on Linux)
`--version X.Y.Z`	`-Version X.Y.Z`	Install a specific version	latest
`--major N`	`-Major N`	Latest of major series N	unset
`--platform NAME`	auto	Override platform	detected
`--arch NAME`	`-Arch NAME`	Override architecture	detected
`--prefix PATH`	`-Prefix PATH`	Install directory	see below
`--list`	`-List`	List available versions	n/a

The default install prefix is /usr/local/bin on bash and %LOCALAPPDATA%\mountOS\bin on PowerShell, where the directory is added to the user PATH automatically. List the available versions of any package without installing:

curl -fsSL https://download.mountos.sh | bash -s -- --pkg mountos-dataserv --list

Packages

Package	Contents	Platforms
`mountos-cli`	The `mountos` client CLI	macOS, Linux, Windows
`mountos-macos`	Signed, notarized installer. FSKit and the Desktop app are each selectable, and the CLI is included and mandatory	macOS universal (arm64 + amd64, one pkg)
`mountos-windows`	Signed installer. The mountosio kernel driver and the CLI	Windows amd64 / arm64
`mountos-appserv`	appserv (the HUB)	Linux amd64 / arm64
`mountos-dataserv`	dataserv (metadata backbone)	Linux amd64 / arm64
`mountos-blockserv`	blockserv (byte plane)	Linux amd64 / arm64
`mountos-gcserv`	gcserv (housekeeping)	Linux amd64 / arm64

The client ships on every platform. Server services ship as Linux binaries for both architectures. Every package archive bundles a license file alongside the binaries. Install a server binary with the same installer, for example --pkg mountos-dataserv.

The S3 and WebHDFS surfaces and the Kubernetes CSI node driver are not separate packages. They are modes of the mountos client, mountos gateway and mountos kubernetes, so they ship inside mountos-cli.

Platforms and architectures

Platform	Architectures	Archive
`darwin`	`arm64`, `amd64` (CLI, per-arch); universal (installer, one pkg)	`.tar.gz` (CLI), `.pkg` (installer)
`linux`	`amd64`, `arm64`	`.tar.gz`
`windows`	`amd64`, `arm64`	`.zip` (CLI), `.exe` (installer)

Platform and architecture are auto-detected and can be overridden. Every platform ships per-arch binaries, no universal/fat binary. The installer verifies the archive against a published SHA-256 before extracting.

Verify and automate

Each package publishes machine-readable manifests under the artifact base, so updates can be detected without scraping the installer. Relative to https://download.mountos.sh:

Path	Purpose
`dist/<pkg>/versions.json`	All known versions plus the current latest
`dist/<pkg>/latest.json`	The latest-version manifest, keyed by platform-arch
`dist/<pkg>/v<major>/latest.json`	Latest within a major series
`dist/<pkg>/<version>/<platform>-<arch>.<ext>`	The release archive, with a sibling `.sha256`

To fetch and verify an artifact by hand:

curl -fSL -o mountos.tar.gz \
  https://download.mountos.sh/dist/mountos-cli/1.2.3/darwin-arm64.tar.gz
curl -fsSL https://download.mountos.sh/dist/mountos-cli/1.2.3/darwin-arm64.sha256
shasum -a 256 mountos.tar.gz
tar -xzf mountos.tar.gz