Welcome to Mina!
Get started setting up a Mina node, learn how to generate a keypair for use with the network, connect to the network, and begin producing blocks.
This documentation is for the Mainnet release.
Software: Supported environments include macOS, Linux (Debian 10, 11 and Ubuntu 20.04 LTS), and any host machine with Docker.
Processor: Only AMD64 CPU architecture is supported.
Hardware: Sending and receiving MINA does not require any special hardware.
Running a block producer on the Mina network requires at least:
- 8-core processor
- 16 GB of RAM
More RAM is required to run a SNARK worker node at the same time as a block producer.
Network: At least 1 Mbps connection
O(1) Labs has tested running nodes on several cloud providers. We recommend the following instances for basic node operator needs. Custom requirements and different cost constraints might require a different instance type.
To install the latest Mainnet Stable Release 1.4.0, use the installation steps for your environment.
The binary download is around 1 GB, so the installation might take a few minutes.
To discover and install pre-release (Beta) builds, see the Mina Releases page on GitHub.
Ubuntu and Debian
To set up the new Debian
stable repository and install the latest binary version:
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 -y curl unzip mina-mainnet=1.4.0-c980ba8
To verify the mina daemon installation, run:
The expected output is
Commit c980ba87c3417f40a7081225dfe7478c5ee70fd7 on branch master.
Windows is not natively supported. Instead, use the Docker instructions.
macOS is used by developers and is not officially supporting any pre-built packages.
Instead, use the Docker instructions or build from source.
Docker is a cross-platform tool. You can download and install Docker on multiple platforms.
Build from source
On Linux or macOS operating systems, you can experiment with Building Mina from source code.
Other operating systems haven't been tested thoroughly and might have issues. You can share logs and get troubleshooting help in the Mina Protocol Discord server.
Set up port forwarding and firewalls
If you are running a firewall, you must allow traffic on TCP port 8302.
-external-ip YOUR_IP flag is provided, the daemon uses HTTPS (443) and HTTP (80) to determine its own IP address.
Enable port forwarding on your router to allow inbound traffic to the following ports through your external IP address:
- TCP port
- To use the GraphQL service, expose TCP port
Now that you've installed mina and configured your network, you can move on to the next step: generating a keypair.