Skip to main content

Run Block Producing Node on Devnet

This guide is intended for setting up block producer nodes on Mina Devnet only. Do not use this guide for Mina Mainnet until necessary security audits are complete.

Prerequisites​

Ensure Docker and Docker Compose are installed on your system - Docker Installation Guide

Download & Start the Node​

  1. Download the Latest Release

  • Visit the Open Mina Releases

  • Download the latest openmina-vX.Y.Z-docker-compose.zip

  • Extract the Files:

    unzip openmina-vX.Y.Z-docker-compose.zip
    cd openmina-vX.Y.Z-docker-compose
    mkdir openmina-workdir

  1. Prepare Your Keys

    Docker Compose references openmina-workdir. It stores a private key and logs for block production. Place your block producer's private key into the openmina-workdir directory and name it producer-key:

    cp /path/to/your/private_key openmina-workdir/producer-key

    Replace /path/to/your/private_key with the actual path to your private key file.

  2. Launch Block Producer

    Use MINA_PRIVKEY_PASS to set the private key password. Optionally, use COINBASE_RECEIVER to set a different coinbase receiver:

    env COINBASE_RECEIVER="YourWalletAddress" MINA_PRIVKEY_PASS="YourPassword" \
    docker compose -f docker-compose.block-producer.yml up -d --pull always

    Optional parameters:

    OPENMINA_LIBP2P_EXTERNAL_IP Sets your node’s external IP address to help other nodes find it.

    OPENMINA_LIBP2P_PORT Sets the port for Libp2p communication.

  3. Go to Dashboard

    Visit http://localhost:8070 to monitor sync and block production.

Access Logs​

Logs are stored in openmina-workdir with filenames like openmina.log.2024-10-14, openmina.log.2024-10-15, etc.

Provide Feedback​

Collect logs from openmina-workdir and report issues on the rust-node-testing discord channel. Include reproduction steps if possible.