docs

Install

The fastest way to install yourspace is to run the command below in your terminal:

install
curl -fsSL https://yo.urspace.net/install.sh | sh

Prefer to download the binary yourself? Pick your platform below — each snippet is the same download-and-place flow the script automates, so you can run it by hand and verify the checksum yourself (see Verify the download).

# Linux x86_64 (most servers + most desktops)
curl -LO https://yo.urspace.net/downloads/linux/amd64/yourspace
chmod +x yourspace
mkdir -p "$HOME/.local/bin" && mv yourspace "$HOME/.local/bin/"
# ~/.local/bin is user-owned — no sudo. Add it to PATH if it isn't already:
#   export PATH="$HOME/.local/bin:$PATH"

# Verify it runs
yourspace --version

The install script downloads the right binary for your machine, checks its SHA256 against the published manifest, and drops it in a directory you own. It installs to ~/.local/bin by default (override with YOURSPACE_INSTALL_DIR), never asks for sudo, and never touches your shell config — it will also print the one line to add if the directory isn't on your PATH yet. Re-running it upgrades in place; once installed, yourspace update keeps it current.

Verify the download

Each release publishes a manifest.json listing the SHA256 hash for every platform's binary. Compare your download against the hash for your platform before running it:

# manifest.json lists the SHA256 for every platform's binary.
curl -fsSL https://yo.urspace.net/downloads/manifest.json

# Compute your download's hash and compare it to the "sha256" under your
# platform's <os>_<arch> entry (e.g. linux_amd64):
sha256sum yourspace        # Linux
shasum -a 256 yourspace    # macOS

Prefer to read shell before you run it?

If you'd rather audit the wire calls before trusting any binary, the Quick-start's shell-script reference is a single readable file covering the lifecycle primitives (login, init, deploy, ls, status) — narrower than the binary, but transparent enough to read end to end first. It's a download-and-review-then-run flow, not a curl | sh install.

Next

You have the binary. Next: the Quick-startyourspace setup from your project directory walks the whole flow (config + token + first deploy) in one command.

macOS — first run

The install script and the curl downloads above run without a Gatekeeper prompt — command-line downloads aren't quarantined. Only if you download the binary through a browser will macOS flag it as unnotarised; in that case run xattr -d com.apple.quarantine yourspace once to clear the flag, or right-click the binary in Finder → Open. Notarisation is on the roadmap.