Skip to main content

Set up and start a node

This section guides you through the complete process of installing PMC, configuring the provider keypair, setting up your node, enabling monitoring, and registering it with the Chromia Mainnet.

Install PMC CLI

Install PMC CLI with Java 21 and verify with pmc --version.

Configure provider key pair

Generate and store your provider key pair with pmc keygen --save, and set up blockchain RID and API URL in PMC.

Prepare the node for deployment

Ensure hardware meets requirements, configure bc-config.xml and node-config.system.properties, and set up keys and network ports.

Enable logging and monitoring

Enable Prometheus monitoring by adding metrics.prometheus.port=9190 and configure logging with log4j2.yml.

Start a node

Install Docker, configure PostgreSQL, and set up node-config.system.properties and bc-config.xml. Run via Docker or natively and configure TLS.

Set up a reverse proxy for TLS

Configure Nginx for TLS using SSL certificates from Let's Encrypt and verify access with telnet and curl.

Add node to the network

Register your node after voting and update the API URL in .chromia/config to include your node's address.

Configure node properties

Set properties through files or environment variables for cryptosystem, database, and network settings. Customize Docker for subnodes as needed.

Node management API

Use the Node Management API in Postchain's managed mode to handle configurations and query peer lists and blockchain settings.

Monitor your node with Prometheus and Grafana

Install Prometheus and Grafana, expose metrics with chr node start -p metrics.prometheus.port=9190, and visualize with Grafana.

Change the FT4 key

Switch to multisig or EVM keys for better security or set up a separate staking account. Use chr and pmc commands for updates and verification.

Node maintenance guidelines

Regular updates are scheduled on Tuesdays; urgent updates may occur anytime. Providers should review proposals and stay updated for optimal performance.