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. It verifies the artifact checksum. It places the artifact 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://mountos.sh/install | bash

Windows (PowerShell):

powershell

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

By default the installer installs the full client bundle on macOS and Windows (the GUI apps plus the mountos CLI). On Linux, it installs only the bare mountos CLI. The installer installs the latest version by default and detects the platform and architecture automatically. Pass --pkg mountos-cli (-Pkg mountos-cli) to install just the CLI on macOS or Windows too.

Where it comes from

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

Installer options

Pass options to the bash installer after --:

curl -fsSL https://mountos.sh/install | 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. The installer adds this directory to the user PATH automatically. List the available versions of any package without installing:

curl -fsSL https://mountos.sh/install | 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 selectable options. The installer always includes the CLI	macOS universal (arm64 + amd64, one pkg)
`mountos-windows`	Signed installer. The mountosio kernel driver and the CLI	Windows amd64 / arm64
`mountos-appserv`	the hub	Linux amd64 / arm64
`mountos-dataserv`	metadata node, serving path	Linux amd64 / arm64
`mountos-blockserv`	storage node	Linux amd64 / arm64
`mountos-gcserv`	metadata node, background work	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. The mountos client implements them as two modes, mountos gateway and mountos kubernetes. Both modes 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)

The installer detects platform and architecture automatically. You can override them. Every platform ships per-architecture binaries. mountOS does not ship a universal or fat binary. The installer verifies the archive against a published SHA-256 checksum. Then it extracts the archive.

Verify and automate

Each package publishes a machine-readable manifest under the artifact base. You can detect updates from the manifest. You do not need to scrape the install script. The paths below are relative to https://mountos.sh/install:

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://mountos.sh/install/dist/mountos-cli/1.2.3/darwin-arm64.tar.gz
curl -fsSL https://mountos.sh/install/dist/mountos-cli/1.2.3/darwin-arm64.sha256
shasum -a 256 mountos.tar.gz
tar -xzf mountos.tar.gz