Install

FleetMesh is three things you install separately. You need the first two for Your first fleet and the third for A browser leaf app.

You want

Install

Needs

a node (meshnode)

the fleetmesh-node Python package

Python 3.11 or newer

the operator’s tool (meshctl)

the meshctl crate

Rust 1.84 or newer

a leaf in a web page

the @fleetmesh/leaf npm package

Node.js 22 or newer

This is an alpha. Every package is a pre-release, so each install below names the pre-release channel explicitly; a plain pip install fleetmesh-node or npm install @fleetmesh/leaf gets an older release.

meshnode

Install it into its own virtual environment:

python3 -m venv ~/.venvs/fleetmesh
source ~/.venvs/fleetmesh/bin/activate
pip install --pre fleetmesh-node

Check that it runs:

meshnode --help

fleetmesh-node brings the rest of the Python family with it (fleetmesh-core, fleetmesh-schema, fleetmesh-protocols), all at the same version. Its only third-party dependency is cryptography.

meshctl

meshctl is a single binary. Build it with Cargo:

cargo install meshctl --version 0.5.0-alpha.1

Check that it runs:

meshctl --version

No Rust toolchain? Install one with rustup, or skip meshctl for now: the browser tutorial does not use it.

@fleetmesh/leaf

There is nothing to install globally: the browser tutorial adds the package to its own project with npm install @fleetmesh/leaf@next. You only need Node.js 22 or newer and npm:

node --version

What is supported

The alpha supports identity, enrolment, fleets, private networks, circles, remote commands (control/1.0), the relay path, the meshctl commands, and the leaf, textile, circles and dm npm packages. Everything else in the code is experimental and off by default: the list is in ALPHA.md.