CHEESE Governance Node Installer

Free, public installer for the CHEESE Blockchain Governance Node. Governance nodes audit the ledger in real-time, verify transactions, and participate in network consensus — available at no cost for government, private sector, and community operators.

Note: Mining and Hybrid node installers are distributed through separate paid subscription channels to prevent NCH network abuse.

Quick Start

npx @cheeseblockchain/node-installer

The interactive wizard will guide you through setup. For non-interactive (CI/CD) usage:

npx @cheeseblockchain/node-installer \
  --flavor governance \
  --install-dir ./cheese-gov-node \
  --yes

System Requirements

Requirement	Minimum	Recommended
RAM	512 MB	1 GB
CPU	1 vCPU	2 vCPU
Disk	500 MB	2 GB
Software	Node.js v20+	Node.js v22 LTS

How It Works

1. Manifest Fetch — Downloads the release manifest from https://cheeseblockchain.com/releases/cheese-node/release-manifest.json (HTTPS only)
2. Artifact Download — Streams each artifact with SHA-256 integrity verification and a 512 MiB size cap
3. Extraction — Unpacks .tgz or .zip archives into the install directory
4. Config Write — Generates node.config.json with RPC and health endpoints

Security Controls

• HTTPS-only — All manifest and artifact URLs must use https:// (exception: localhost/private IPs for local development)
• SHA-256 verification — Every downloaded byte is hashed and compared against the manifest
• Path traversal prevention — Install paths are validated against ../, absolute paths, and special characters
• Size caps — Downloads abort at 512 MiB to prevent disk-fill attacks
• Atomic writes — Uses temp file + rename to prevent half-written configs

CLI Options

cheese-node-install [options]

Options:
  -h, --help                 Show help
  -m, --manifest <url|path>  Release manifest (HTTPS URL or local JSON file)
      --local-only           Write node.config.json only (skip downloads)
  -f, --flavor <name>        governance (only supported flavor in this package)
  -d, --install-dir <path>   Install directory (default: ./cheese-node-governance)
      --rpc-url <url>        Override RPC URL (with --local-only)
      --api-health-url <url> Override health URL (with --local-only)
      --dry-run              Preview actions without writing files
  -y, --yes                  Non-interactive confirmation

Local-Only Mode

If you already have the CHEESE repository cloned, you can generate a node.config.json without downloading any artifacts:

npx @cheeseblockchain/node-installer \
  --local-only \
  --flavor governance \
  --install-dir ./cheese-gov-node \
  --rpc-url https://cheeseblockchain.com/api/rpc \
  --yes

Then start the node:

export CHEESE_NODE_TYPE=governance
node path/to/start-server.js

Running Tests

npm test

License

MIT — Free for everyone. Government auditors, private operators, and community members can use, modify, and redistribute this installer without restriction.