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​

Mina packages are published to the signed repository stable.apt.packages.minaprotocol.com. The repository is served over HTTPS and every release index is signed with the Mina repository key (fingerprint 386E9DAC 378726A4 8ED5CE56 ADB30D9A CE02F414). Download the key once, then add the repository with signed-by so that apt verifies each package before it is installed.

sudo rm -f /etc/apt/sources.list.d/mina*.list
sudo apt-get install --yes curl ca-certificates lsb-release
sudo curl -fsSL https://stable.apt.packages.minaprotocol.com/repo-signing-key.gpg -o /usr/share/keyrings/mina-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/mina-archive-keyring.gpg] https://stable.apt.packages.minaprotocol.com $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/mina.list
sudo apt-get update
sudo apt-get install --yes unzip mina-mainnet=4.0.3-73134bf

The same key is also available as an ASCII-armored file at https://stable.apt.packages.minaprotocol.com/repo-signing-key.asc.

note
Legacy repository packages.o1test.net

Older guides add deb [trusted=yes] http://packages.o1test.net <codename> stable. That repository is not signed and is served over plain HTTP, so apt cannot verify the packages it downloads. For historical reasons, and to keep compatibility with the flow that many operators are used to, packages.o1test.net continues to receive the same releases and stays available for some time. New installations should use the signed repository above. To migrate an existing node, remove the old source file and add the signed one as shown; the installed package versions do not change.

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​