midnight-node:node-operations

Deploy, monitor, and troubleshoot Midnight blockchain nodes across environments.

37|9|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/devrelaicom/midnight-expert --skill midnight-node-node-operations
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: midnight-node:node-operations
Source: https://github.com/devrelaicom/midnight-expert/tree/main/plugins/midnight-node/skills/node-operations
Command: npx skills add https://github.com/devrelaicom/midnight-expert --skill midnight-node-node-operations

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Operators and developers need clear, actionable guidance to deploy, monitor, and troubleshoot Midnight blockchain nodes across validator, full, archive, and development modes to avoid downtime, consensus stalls, and state corruption.

Core Features & Use Cases

  • Multi-mode Operations: Instructions for running validator, full, archive, and development nodes with required keys and hardware considerations.
  • Deployment & Monitoring: Docker deployment patterns, port and volume mappings, Prometheus metrics, memory monitoring, and graceful shutdown behavior for production readiness.
  • Diagnostics & Troubleshooting: Practical checks and RPC diagnostic commands for health, sync state, peers, consensus rounds, and common failure modes such as finalization stalls and IPC errors.
  • Use Case: Deploy a Dockerized full node with Prometheus metrics, verify sync and peers, and troubleshoot a node that is not finalizing blocks.

Quick Start

Start a preview full node in Docker with RPC and Prometheus exposed and then run the health, sync, and peers RPC checks to verify the node is syncing and reachable.

Frequently Asked Questions about midnight-node:node-operations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a Midnight node using Docker with Prometheus monitoring?

To deploy a Midnight node, use Docker deployment patterns with specified port and volume mappings, exposing RPC on 9944 and Prometheus metrics on 9615 to enable memory monitoring and production readiness.

Why is my Midnight node not finalizing blocks?

When a Midnight node is not finalizing blocks, use diagnostic RPC commands to inspect health, sync state, peers, and consensus rounds to identify common failure modes like finalization stalls or IPC errors.

What ports do I need to open for running a Midnight validator node?

Running a Midnight validator node requires opening port 9944 for RPC endpoints, 30333 for P2P configuration, and 9615 for Prometheus metrics to ensure proper network communication and monitoring.

Can I run different types of Midnight nodes such as archive or development nodes?

Yes, you can run validator, full, archive, and development Midnight nodes. Each mode has specific hardware considerations, state pruning options, and required keys for multi-mode operations across local, staging, and production environments.

How do I check the health and sync state of a Midnight node?

Check the health and sync state of a Midnight node by running diagnostic RPC commands that verify peer connectivity, block synchronization, and consensus inspection to ensure the node is reachable and properly syncing.