Falcon Values File Reference

Comprehensive reference for all supported CLI flags per section of a Falcon values file, including defaults, types, and descriptions. Use this as your source of truth when customizing Falcon deployments.
Categories:
Tags:

Overview

This page catalogs the Solo CLI flags accepted under each top-level section of a Falcon values file. Each entry corresponds to the command-line flag that the underlying Solo subcommand accepts.

Sections map to subcommands as follows:

SectionSolo subcommand
networksolo consensus network deploy
setupsolo consensus node setup
consensusNodesolo consensus node start
mirrorNodesolo mirror node add
explorerNodesolo explorer node add
relayNodesolo relay node add
blockNodesolo block node add

All flag names must be written in long form with double dashes (for example, --release-tag). Flags left empty ("") or matching their default value are ignored by Solo at argument expansion time.

Note: Not every flag listed here is relevant to every deployment. Use this page as a lookup when writing or debugging a values file. For a working example file, see the upstream reference at https://github.com/hiero-ledger/solo/tree/main/examples/one-shot-falcon.

Consensus Network Deploy — network

Flags passed to solo consensus network deploy.

FlagTypeDefaultDescription
--release-tagstringcurrent Hedera platform versionConsensus node release tag (e.g. v0.71.0).
--pvcsbooleanfalseEnable Persistent Volume Claims for consensus node storage. Required for node add operations.
--load-balancerbooleanfalseEnable load balancer for network node proxies.
--chart-dirstring—Path to a local Helm chart directory for the Solo network chart.
--solo-chart-versionstringcurrent chart versionSpecific Solo testing chart version to deploy.
--haproxy-ipsstring—Static IP mapping for HAProxy pods (e.g. node1=127.0.0.1,node2=127.0.0.2).
--envoy-ipsstring—Static IP mapping for Envoy proxy pods.
--debug-node-aliasstring—Enable the default JVM debug port (5005) for the specified node alias.
--domain-namesstring—Custom domain name mapping per node alias (e.g. node1=node1.example.com).
--grpc-tls-certstring—TLS certificate path for gRPC, per node alias (e.g. node1=/path/to/cert).
--grpc-web-tls-certstring—TLS certificate path for gRPC Web, per node alias.
--grpc-tls-keystring—TLS certificate key path for gRPC, per node alias.
--grpc-web-tls-keystring—TLS certificate key path for gRPC Web, per node alias.
--storage-typestringminio_onlyStream file storage backend. Options: minio_only, aws_only, gcs_only, aws_and_gcs.
--gcs-write-access-keystring—GCS write access key.
--gcs-write-secretsstring—GCS write secret key.
--gcs-endpointstring—GCS storage endpoint URL.
--gcs-bucketstring—GCS bucket name.
--gcs-bucket-prefixstring—GCS bucket path prefix.
--aws-write-access-keystring—AWS write access key.
--aws-write-secretsstring—AWS write secret key.
--aws-endpointstring—AWS storage endpoint URL.
--aws-bucketstring—AWS bucket name.
--aws-bucket-regionstring—AWS bucket region.
--aws-bucket-prefixstring—AWS bucket path prefix.
--settings-txtstringtemplatePath to a custom settings.txt file for consensus nodes.
--application-propertiesstringtemplatePath to a custom application.properties file.
--application-envstringtemplatePath to a custom application.env file.
--api-permission-propertiesstringtemplatePath to a custom api-permission.properties file.
--bootstrap-propertiesstringtemplatePath to a custom bootstrap.properties file.
--log4j2-xmlstringtemplatePath to a custom log4j2.xml file.
--genesis-throttles-filestring—Path to a custom throttles.json file for network genesis.
--service-monitorbooleanfalseInstall a ServiceMonitor custom resource for Prometheus metrics.
--pod-logbooleanfalseInstall a PodLog custom resource for node pod log monitoring.
--quiet-modebooleanfalseSuppress confirmation prompts.
--values-filestring—Comma-separated Helm chart values file paths (not the Falcon values file).

Consensus Node Setup — setup

Flags passed to solo consensus node setup.

FlagTypeDefaultDescription
--release-tagstringcurrent Hedera platform versionConsensus node release tag. Must match network.--release-tag.
--local-build-pathstring—Path to a local Hiero consensus node build (e.g. ~/hiero-consensus-node/hedera-node/data). Used for local development workflows.
--appstringHederaNode.jarName of the consensus node application binary.
--app-configstring—Path to a JSON configuration file for the testing app.
--admin-public-keysstring—Comma-separated DER-encoded ED25519 public keys in node alias order.
--domain-namesstring—Custom domain name mapping per node alias.
--devbooleanfalseEnable developer mode.
--quiet-modebooleanfalseSuppress confirmation prompts.
--cache-dirstring~/.solo/cacheLocal cache directory for downloaded artifacts.

Consensus Node Start — consensusNode

Flags passed to solo consensus node start.

FlagTypeDefaultDescription
--force-port-forwardbooleantrueForce port forwarding to access network services locally.
--stake-amountsstring—Comma-separated stake amounts in node alias order (e.g. 100,100,100). Required for multi-node deployments that need non-default stakes.
--state-filestring—Path to a zipped state file to restore the network from.
--debug-node-aliasstring—Enable JVM debug port (5005) for the specified node alias.
--appstringHederaNode.jarName of the consensus node application binary.
--quiet-modebooleanfalseSuppress confirmation prompts.

Mirror Node Add — mirrorNode

Flags passed to solo mirror node add.

FlagTypeDefaultDescription
--mirror-node-versionstringcurrent versionMirror node Helm chart version to deploy.
--enable-ingressbooleanfalseDeploy an ingress controller for the mirror node.
--force-port-forwardbooleantrueEnable port forwarding for mirror node services.
--pingerbooleanfalseEnable the mirror node Pinger service.
--mirror-static-ipstring—Static IP address for the mirror node load balancer.
--domain-namestring—Custom domain name for the mirror node.
--ingress-controller-value-filestring—Path to a Helm values file for the ingress controller.
--mirror-node-chart-dirstring—Path to a local mirror node Helm chart directory.
--use-external-databasebooleanfalseConnect to an external PostgreSQL database instead of the chart-bundled one.
--external-database-hoststring—Hostname of the external database. Requires --use-external-database.
--external-database-owner-usernamestring—Owner username for the external database.
--external-database-owner-passwordstring—Owner password for the external database.
--external-database-read-usernamestring—Read-only username for the external database.
--external-database-read-passwordstring—Read-only password for the external database.
--storage-typestringminio_onlyStream file storage backend for the mirror node importer.
--storage-read-access-keystring—Storage read access key for the mirror node importer.
--storage-read-secretsstring—Storage read secret key for the mirror node importer.
--storage-endpointstring—Storage endpoint URL for the mirror node importer.
--storage-bucketstring—Storage bucket name for the mirror node importer.
--storage-bucket-prefixstring—Storage bucket path prefix.
--storage-bucket-regionstring—Storage bucket region.
--operator-idstring—Operator account ID for the mirror node.
--operator-keystring—Operator private key for the mirror node.
--quiet-modebooleanfalseSuppress confirmation prompts.
--values-filestring—Comma-separated Helm chart values file paths for the mirror node chart.

Explorer Add — explorerNode

Flags passed to solo explorer node add.

FlagTypeDefaultDescription
--explorer-versionstringcurrent versionHiero Explorer Helm chart version to deploy.
--enable-ingressbooleanfalseDeploy an ingress controller for the explorer.
--force-port-forwardbooleantrueEnable port forwarding for the explorer service.
--domain-namestring—Custom domain name for the explorer.
--ingress-controller-value-filestring—Path to a Helm values file for the ingress controller.
--explorer-chart-dirstring—Path to a local Hiero Explorer Helm chart directory.
--explorer-static-ipstring—Static IP address for the explorer load balancer.
--enable-explorer-tlsbooleanfalseEnable TLS for the explorer. Requires cert-manager.
--explorer-tls-host-namestringexplorer.solo.localHostname used for the explorer TLS certificate.
--tls-cluster-issuer-typestringself-signedTLS cluster issuer type. Options: self-signed, acme-staging, acme-prod.
--mirror-node-idnumber—ID of the mirror node instance to connect the explorer to.
--mirror-namespacestring—Kubernetes namespace of the mirror node.
--solo-chart-versionstringcurrent versionSolo chart version used for explorer cluster setup.
--quiet-modebooleanfalseSuppress confirmation prompts.
--values-filestring—Comma-separated Helm chart values file paths for the explorer chart.

JSON-RPC Relay Add — relayNode

Flags passed to solo relay node add.

FlagTypeDefaultDescription
--relay-releasestringcurrent versionHiero JSON-RPC Relay Helm chart release to deploy.
--node-aliasesstring—Comma-separated node aliases the relay will observe (e.g. node1 or node1,node2).
--replica-countnumber1Number of relay replicas to deploy.
--chain-idstring298EVM chain ID exposed by the relay (Hedera testnet default).
--force-port-forwardbooleantrueEnable port forwarding for the relay service.
--domain-namestring—Custom domain name for the relay.
--relay-chart-dirstring—Path to a local Hiero JSON-RPC Relay Helm chart directory.
--operator-idstring—Operator account ID for relay transaction signing.
--operator-keystring—Operator private key for relay transaction signing.
--mirror-node-idnumber—ID of the mirror node instance the relay will query.
--mirror-namespacestring—Kubernetes namespace of the mirror node.
--quiet-modebooleanfalseSuppress confirmation prompts.
--values-filestring—Comma-separated Helm chart values file paths for the relay chart.

Block Node Add — blockNode

Flags passed to solo block node add.

Important: The blockNode section is only read when ONE_SHOT_WITH_BLOCK_NODE=true is set in the environment. Otherwise Solo skips the block node add step regardless of whether a blockNode section is present. Version requirements: Consensus node ≥ v0.72.0 and block node ≥ 0.29.0. Use --force to bypass version gating during testing.

FlagTypeDefaultDescription
--release-tagstringcurrent versionHiero block node release tag.
--image-tagstring—Docker image tag to override the Helm chart default.
--enable-ingressbooleanfalseDeploy an ingress controller for the block node.
--domain-namestring—Custom domain name for the block node.
--devbooleanfalseEnable developer mode for the block node.
--block-node-chart-dirstring—Path to a local Hiero block node Helm chart directory.
--quiet-modebooleanfalseSuppress confirmation prompts.
--values-filestring—Comma-separated Helm chart values file paths for the block node chart.

Top-Level Falcon Command Flags

The following flags are passed directly on the solo one-shot falcon deploy command line. They are not read from the values file sections.

FlagTypeDefaultDescription
--values-filestring—Path to the Falcon values YAML file.
--deploymentstringone-shotDeployment name for Solo’s internal state.
--namespacestringone-shotKubernetes namespace to deploy into.
--cluster-refstringone-shotCluster reference name.
--num-consensus-nodesnumber1Number of consensus nodes to deploy.
--deploy-mirror-nodebooleantrueDeploy or skip the mirror node.
--deploy-explorerbooleantrueDeploy or skip the explorer.
--deploy-relaybooleantrueDeploy or skip the JSON-RPC relay.
--no-rollbackbooleanfalseDisable automatic cleanup on deployment failure. Preserves partial resources for inspection.
--quiet-modebooleanfalseSuppress all interactive prompts.
--forcebooleanfalseForce actions that would otherwise be skipped.
Last modified April 7, 2026: docs(site): add prev/next page navigation and fix markdown lint errors (#70) (5588ce6)