Supported Distributions
- Ubuntu Focal (20.04 LTS)
- Ubuntu Jammy (22.04 LTS) **
- Ubuntu Noble (24.04 LTS) *
- Debian Bullseye (11)
- Debian Bookworm (12) *
* Supported starting from Mina version 3.1.0 and newer
** Supported starting from Mina version 3.3.0-alpha1 and newer
** Supported starting from Mina version 3.3.0-alpha1 and newer
Supported Architectures
| Architecture | Description | Support Status |
|---|---|---|
| amd64 | 64-bit x86 processors (Intel/AMD) | Full Support |
| arm64 | 64-bit ARM processors (Apple Silicon, AWS Graviton) |
Bookworm
Noble
|
Available Packages
| Package | Network | Debian Name |
|---|---|---|
| Mina Node | Mainnet | mina-mainnet |
| Mina Rosetta Node | Mainnet | mina-rosetta-mainnet |
| Archive Node | Mainnet | mina-archive-mainnet |
| Archive Node | Devnet | mina-archive-devnet |
| Mina Node | Devnet | mina-devnet |
| Mina Rosetta Node | Devnet | mina-rosetta-devnet |
| Archive Node | Mesa | mina-archive-mesa |
| Mina Node | Mesa | mina-mesa |
| Mina Rosetta Node | Mesa | mina-rosetta-mesa |
Available Release Channels Summary
| Channel | Risk Level | Target Network | Current Version | Description |
|---|---|---|---|---|
|
ฮฒ
Beta
Release Candidate
|
Low | Mainnet | v3.2.0-beta2 |
Pre-production releases ready for final testing and staging environments |
|
ฮฑ
Alpha
Early Testing
|
Medium | Devnet | v3.2.0-alpha1 |
Cutting-edge development builds for research and protocol testing |
|
๐ค
Preflight
Experimental
|
High | Mesa* | v4.0.0-preflight1 |
Experimental builds for forward-compatibility testing. Breakage expected, internal adoption first |
* Mesa is a preview network available for testing. You can connect to this network to test upcoming hardfork features before they are released to mainnet.
Testing Release Channels
Beta and alpha channels for early access to new features and testing upcoming releases.
Beta
Release Candidate
Pre-production releases for early adopters. These packages are promoted from alpha after successful devnet validation and represent feature-complete implementations ready for final testing. Ideal for organizations that want to evaluate upcoming features and provide feedback before stable release.
๐ Early Access
First access to new features and protocol improvements
๐งช Testing Focus
Suitable for mainnet testing environments and staging deployments
๐ Performance Data
Help collect real-world performance metrics and edge case scenarios
๐ Regular Updates
Frequent updates with bug fixes and feature refinements
Alpha
Early Testing
Cutting-edge development builds for research and testing. These packages contain the latest experimental features, protocol changes, and performance optimizations. Essential for protocol researchers, core developers, and community members contributing to Mina's evolution. Not suitable for production use.
๐ฌ Research Focus
Experimental consensus mechanisms and cryptographic improvements
โ ๏ธ Known Issues
May contain bugs and breaking changes - use with caution
๐๏ธ Protocol Development
Test new protocol features and network upgrade mechanisms
๐ฅ Community Testing
Help validate features before promotion to beta channel
Preflight
Experimental
Experimental builds for forward-compatibility testing and early upgrade validation. Preflight releases are used to test if new builds work before promoting to alpha. These packages may break and should be used for internal adoption first. Breakage is expected as these releases help identify issues early in the development cycle.
๐งช Experimental Builds
Test new builds before wider distribution
โ ๏ธ Breakage Expected
May contain critical bugs - internal use recommended
๐ Forward Compatibility
Test compatibility with upcoming protocol changes
๐ข Internal First
Intended for internal team testing before external release
Latest Testing Versions
Current beta and alpha versions available for testing environments.
Beta
Release Candidatev3.2.0-beta2
Switch to beta channel:
echo "deb https://unstable.apt.packages.minaprotocol.com bullseye beta" > /etc/apt/sources.list.d/mina.list
Then install specific version:
apt-get update && apt-get install -y mina-mainnet=3.2.0-beta2*
- mina-mainnet=3.2.0-beta2* - Mainnet node (beta)
- mina-devnet=3.2.0-beta2* - Devnet node (beta)
- mina-mesa=3.2.0-beta2* - Mesa node (beta)
- mina-archive-mainnet=3.2.0-beta2* - Archive node mainnet (beta)
- mina-archive-devnet=3.2.0-beta2* - Archive node devnet (beta)
- mina-archive-mesa=3.2.0-beta2* - Archive node mesa (beta)
- mina-rosetta-mainnet=3.2.0-beta2* - Rosetta API mainnet (beta)
- mina-rosetta-devnet=3.2.0-beta2* - Rosetta API devnet (beta)
- mina-rosetta-mesa=3.2.0-beta2* - Rosetta API mesa (beta)
Alpha
Early Testingv3.3.0-alpha1
Switch to alpha channel:
echo "deb https://unstable.apt.packages.minaprotocol.com bullseye alpha" > /etc/apt/sources.list.d/mina.list
Then install specific version:
apt-get update && apt-get install -y mina-mainnet=3.2.0-alpha1*
- mina-mainnet=3.2.0-alpha1* - Mainnet node (alpha)
- mina-devnet=3.2.0-alpha1* - Devnet node (alpha)
- mina-mesa=3.2.0-alpha1* - Mesa node (alpha)
- mina-archive-mainnet=3.2.0-alpha1* - Archive node mainnet (alpha)
- mina-archive-devnet=3.2.0-alpha1* - Archive node devnet (alpha)
- mina-archive-mesa=3.2.0-alpha1* - Archive node mesa (alpha)
- mina-rosetta-mainnet=3.2.0-alpha1* - Rosetta API mainnet (alpha)
- mina-rosetta-devnet=3.2.0-alpha1* - Rosetta API devnet (alpha)
- mina-rosetta-mesa=3.2.0-alpha1* - Rosetta API mesa (alpha)
Preflight
Experimentalv4.0.0-preflight1
Switch to preflight channel:
echo "deb https://unstable.apt.packages.minaprotocol.com bullseye preflight" > /etc/apt/sources.list.d/mina.list
Then install specific version:
apt-get update && apt-get install -y mina-mesa=4.0.0-preflight1*
- mina-mesa=4.0.0-preflight1* - Mesa node (preflight)
- mina-archive-mesa=4.0.0-preflight1* - Archive node mesa (preflight)
- mina-rosetta-mesa=4.0.0-preflight1* - Rosetta API mesa (preflight)
Debian Installation Guide
To install Mina unstable packages through the APT repository, follow these steps:
1Install Dependencies (Optional)
Install required dependencies if not already present:
apt-get install -y lsb-release ca-certificates wget gnupg
Update package cache:
apt-get update
2Import Repository Signing Key
Download and install the Mina repository signing key:
wget -q https://unstable.apt.packages.minaprotocol.com/repo-signing-key.gpg -O /etc/apt/trusted.gpg.d/minaprotocol.gpg
Update package cache after adding the key:
apt-get update
3Add Mina APT Repository
Add the Mina testing APT repository:
echo "deb https://unstable.apt.packages.minaprotocol.com bullseye beta" > /etc/apt/sources.list.d/mina.list
Distribution Codenames: Replace
Auto-detect your codename:
bullseye with your distribution codename.
Auto-detect your codename:
lsb_release -c
Or use these common codenames:
- Ubuntu 20.04:
focal - Ubuntu 22.04:
jammy - Ubuntu 24.04:
noble - Debian 11:
bullseye - Debian 12:
bookworm
4Install Mina Package
Update package list and install Mina:
apt-get update
apt-get install -y mina-mainnet
Package Selection: Replace
๐ Note: Beta packages are suitable for testing and staging environments. Alpha packages should only be used for development and research purposes.
mina-mainnet with the appropriate package name from the table above (e.g., mina-devnet, mina-archive-mainnet, mina-rosetta-devnet, etc.).
๐ Note: Beta packages are suitable for testing and staging environments. Alpha packages should only be used for development and research purposes.