Skip to main content

Installation

Supported environments include Linux (Debian 10, 11, 12 and Ubuntu 20.04, 22.04 and 24.04), any host with Docker, and macOS (build from source). The binary download is around 1 GB.

For pre-release builds, see the Mina Releases page on GitHub.

Install by platform​

Ubuntu and Debian​

sudo rm /etc/apt/sources.list.d/mina*.list
echo "deb [trusted=yes] http://packages.o1test.net $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/mina.list
sudo apt-get update
sudo apt-get install --yes curl unzip mina-mainnet=4.0.0-6850301

Docker​

Docker is cross-platform (Linux, macOS, Windows). Install Docker from Get Docker, then follow the Connect to the Mina Network instructions to run the daemon as a container.

Windows​

Windows is not natively supported. Use the Docker instructions instead.

macOS​

No pre-built packages are available for macOS. Use Docker or build from source.

Build from source​

On Linux or macOS, you can build from source by following the Building Mina instructions.

Verify your installation​

mina version

The output should include a Commit line.

Node profile​

A Mina binary starts only when it knows its node profile: mainnet, devnet, lightnet, or dev. The profile selects the constants of the network.

  • The mina-mainnet and mina-devnet packages and the Docker images write the profile of their network to /etc/coda/build_config/PROFILE.
  • The MINA_PROFILE environment variable has priority over that file. Use it only when you run a binary with a profile that is different from its package, for example a binary built from source. The runtime configuration and the genesis ledger must agree with the profile.

If no profile is set, the binary stops at startup. See Node config: no profile set.

Next steps​