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 CLIInstall PMC CLI with Java 21 and verify with
pmc --version.Configure provider key pairGenerate and store your provider key pair with pmc keygen --save, and set up blockchain RID and API URL in PMC.Prepare the node for deploymentEnsure hardware meets requirements, configure bc-config.xml and node-config.system.properties, and set up keys
and network ports.Enable logging and monitoringEnable Prometheus monitoring by adding metrics.prometheus.port=9190 and configure logging with log4j2.yml.Start a nodeInstall 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 TLSConfigure Nginx for TLS using SSL certificates from Let's Encrypt and verify access with telnet and curl.Add node to the networkRegister your node after voting and update the API URL in .chromia/config to include your node's address.Configure node propertiesSet properties through files or environment variables for cryptosystem, database, and network settings. Customize
Docker for subnodes as needed.Node management APIUse 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 GrafanaInstall Prometheus and Grafana, expose metrics with chr node start -p metrics.prometheus.port=9190, and
visualize with Grafana.Change the FT4 keySwitch to multisig or EVM keys for better security or set up a separate staking account. Use chr and pmc
commands for updates and verification.Upgrade PostchainStep-by-step guide to upgrade Postchain containers, including special instructions for subnodes and Mainnet
validator nodes.Node maintenance guidelinesRegular updates are scheduled on Tuesdays; urgent updates may occur anytime. Providers should review proposals and
stay updated for optimal performance.Configure Directory ChainConfigure Directory Chain module arguments, ICMF settings, and delayed blockchain configurations.Configure Economy ChainSet up Economy Chain module arguments, FT4 configuration, ICMF and EIF settings for asset management and staking.