|
| 1 | +--- |
| 2 | +sidebar_position: 5 |
| 3 | +title: Alpha Testing Guide |
| 4 | +description: Guide to running the Alpha Rust Node on Devnet |
| 5 | +--- |
| 6 | + |
| 7 | +# Run Non-Block Producing Node on Devnet |
| 8 | + |
| 9 | +This guide will walk you through running the **Alpha Rust Node** on Devnet using |
| 10 | +Docker. Follow these steps to set up the node and |
| 11 | +[Provide Feedback](#4-provide-feedback) on this Alpha release. |
| 12 | + |
| 13 | +## 1. Prerequisites |
| 14 | + |
| 15 | +Ensure you have **Docker** installed: |
| 16 | + |
| 17 | +- [Docker Installation Guide for Linux, macOS, and Windows](./docker-installation.md) |
| 18 | + |
| 19 | +## 2. Download & Start the Node |
| 20 | + |
| 21 | +1. **Download the Latest Release**: |
| 22 | + - Visit the |
| 23 | + [Open Mina Releases](https://github.com/openmina/openmina/releases). |
| 24 | + - Download the latest `openmina-vX.Y.Z-docker-compose.zip`. |
| 25 | + |
| 26 | +2. **Extract the Files**: |
| 27 | + |
| 28 | + ```bash |
| 29 | + unzip openmina-vX.Y.Z-docker-compose.zip |
| 30 | + cd openmina-vX.Y.Z-docker-compose |
| 31 | + ``` |
| 32 | + |
| 33 | + Additional optional parameters: |
| 34 | + |
| 35 | + `OPENMINA_LIBP2P_EXTERNAL_IP` Sets your node’s external IP address to help |
| 36 | + other nodes find it. |
| 37 | + |
| 38 | + `OPENMINA_LIBP2P_PORT` Sets the port for Libp2p communication. |
| 39 | + |
| 40 | +3. **Start the Node on Devnet and Save Logs**: Start the node and save the logs |
| 41 | + for later analysis: |
| 42 | + |
| 43 | + ```bash |
| 44 | + docker compose up --pull always && docker compose logs > openmina-node.log |
| 45 | + ``` |
| 46 | + |
| 47 | +4. **Access the Dashboard**: Open `http://localhost:8070` in your browser. |
| 48 | + |
| 49 | + The dashboard will show the syncing process in real time. |
| 50 | + <img width="1417" alt="image" src="https://github.com/user-attachments/assets/d9a5f5b3-522f-479b-9829-37402c63bb98" /> |
| 51 | + |
| 52 | + > **1. Connecting to Peers:** The node connects to peers. You’ll see the |
| 53 | + > number of connected, connecting, and disconnected peers grow. |
| 54 | + > |
| 55 | + > **2. Fetching Ledgers:** The node downloads key data: Staking ledger, Next |
| 56 | + > epoch ledger, and Snarked ledger. Progress bars show the download status. |
| 57 | + > |
| 58 | + > **3. Fetching & Applying Blocks:** The node downloads recent blocks to |
| 59 | + > match the network’s current state. The dashboard tracks how many blocks are |
| 60 | + > fetched and applied. |
| 61 | +
|
| 62 | +## 3. Monitoring and troubleshooting |
| 63 | + |
| 64 | +### Inspecting Saved Logs |
| 65 | + |
| 66 | +If you’ve saved logs to a file, you can use tail or similar tools to view them: |
| 67 | + |
| 68 | +```bash |
| 69 | +tail -f openmina-node.log |
| 70 | +``` |
| 71 | + |
| 72 | +### Restart the Node: |
| 73 | + |
| 74 | +If the node becomes unresponsive or fails to start, restart the setup: |
| 75 | + |
| 76 | +```bash |
| 77 | +docker compose down |
| 78 | +docker compose up --pull always |
| 79 | +``` |
| 80 | + |
| 81 | +## 4. Provide Feedback |
| 82 | + |
| 83 | +This Alpha release is for testing purposes. Your feedback is essential. Follow |
| 84 | +these steps to report any issues: |
| 85 | + |
| 86 | +1. **Collect Logs**: Use the |
| 87 | + [commands above to save logs](#2-download--start-the-node) |
| 88 | +2. **Visit Discord**: |
| 89 | + [Open Mina Discord Channel](https://discord.com/channels/484437221055922177/1290662938734231552/1290667779317305354) |
| 90 | +3. **Describe the Issue**: Briefly explain the problem and steps to reproduce it |
| 91 | +4. **Attach Logs**: Discord allows files up to 25MB. If your logs are larger, |
| 92 | + use Google Drive or similar |
| 93 | +5. **Include a Screenshot**: A dashboard screenshot provides details about node |
| 94 | + status, making it easier to diagnose the issue |
0 commit comments