Skip to main content
Install, update, and uninstall the mxnode binary. POSIX shell installer with sha256 verification.

Shortest command

curl -fsSL https://raw.githubusercontent.com/XOXNO/mx-node/main/install.sh | sh
mxnode --version
Detects OS + CPU, downloads the matching release tarball, sha256-verifies against SHA256SUMS, and copies the binary into /usr/local/bin.

Options

Pass options after sh -s --:
curl -fsSL https://raw.githubusercontent.com/XOXNO/mx-node/main/install.sh \
  | sh -s -- --version v0.1.0 --dir "$HOME/.local/bin"
OptionDefaultEffect
--version <TAG>latestPin a specific release.
--dir <PATH>/usr/local/binInstall location. Use $HOME/.local/bin for a rootless install.
--helpPrint usage.

Supported targets

OSCPUTarball
Linuxx86_64mxnode-<TAG>-x86_64-unknown-linux-musl.tar.gz
Linuxaarch64mxnode-<TAG>-aarch64-unknown-linux-musl.tar.gz
macOSx86_64mxnode-<TAG>-x86_64-apple-darwin.tar.gz
macOSarm64mxnode-<TAG>-aarch64-apple-darwin.tar.gz
Linux builds are statically linked against musl — no glibc version requirement.

Required tools

ToolWhy
curlDownload the tarball + SHA256SUMS
tarExtract the binary
sha256sum or shasumVerify the download. The installer refuses to run without one.
sudoOnly when the install dir isn’t operator-writable

Rootless install

curl -fsSL https://raw.githubusercontent.com/XOXNO/mx-node/main/install.sh \
  | sh -s -- --dir "$HOME/.local/bin"
If $HOME/.local/bin isn’t on your PATH:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc

Update

Re-run the installer. The new binary overwrites the old in place. Existing nodes (elrond-node-{i}.service) are untouched — the upgrade is to the CLI, not to the node binaries.
curl -fsSL https://raw.githubusercontent.com/XOXNO/mx-node/main/install.sh | sh

Uninstall

mxnode places exactly one file: the binary at the install dir.
sudo rm /usr/local/bin/mxnode
To also wipe the host’s mxnode-managed nodes + state + config + binstore, run cleanup before removing the binary.

Under the hood

  1. Detect OS (Linux/Darwin) and CPU (x86_64/aarch64).
  2. Resolve the release tag — explicit --version or latest from the GitHub API.
  3. Download mxnode-<TAG>-<TARGET>.tar.gz and SHA256SUMS.
  4. Compute the local sha256 and compare. Refuse on mismatch.
  5. Extract to a tempdir, then install -m 0755 the binary into --dir (with sudo if needed).
  6. Print the version.
The installer does not modify your shell rc, write any config, or contact anything outside github.com.