Deployment Scripts

This page lists the canonical user-run deployment scripts and peer-list resources referenced by the c8ntinuum docs. These endpoints are intended for downloading scripts and network bootstrap metadata before running them locally.

Canonical resources

Resource	Purpose	Hosted endpoint	Main docs
`deploy.sh`	Install, state-sync, start, stop, inspect, and reset non-validator `ctmd` nodes.	`https://resources.c8ntinuum.io/deploy.sh`	Full Node Installation, State Sync
`local_node.sh`	Start the canonical local single-node c8ntinuum developer chain from a source checkout.	Repository-root script, not a hosted metadata artifact	Local Development
`peers.json`	Provide seeds, persistent peers, and trusted state-sync RPCs used by node deployment.	`https://resources.c8ntinuum.io/peers.json`	Full Node Block Delivery, State Sync

Validators do not use deploy.sh. They install ctmd by hand with the manual mainnet install, which mirrors what deploy.sh install and deploy.sh state-sync do. This inventory intentionally excludes example, administrative, and framework-specific scripts such as migrate.js, scripts/deploy.js, arguments.js, npm scripts, make targets, Foundry commands, and ctmd commands.

Deploy script

To install or update ctmd, run the deploy.sh script. You can download and run the script manually:

curl -fsSL https://resources.c8ntinuum.io/deploy.sh -o deploy.sh
chmod +x deploy.sh

# Linux: run as root
sudo ./deploy.sh install --moniker <your-node-moniker>

# macOS: run as your normal user, without sudo
./deploy.sh install --moniker <your-node-moniker>

Keep the downloaded script so you can inspect it before running it and reuse it for lifecycle commands.

Supported operator commands:

Command	Purpose
`install --moniker NAME [--chain-id ID] [-y]`	Download the latest metadata-backed release, install it, initialize the node home, download genesis, and patch peers.
`state-sync [-y] [--lag N] [--rpc-1 URL] [--rpc-2 URL] [--p2p-host-1 HOST] [--p2p-host-2 HOST]`	Configure state sync, reset local chain data, wait for catch-up, then disable state sync.
`start`	Start the managed node.
`stop`	Stop the managed node.
`status`	Show install, service, local RPC, height, sync, and peer status.
`reset [-y]`	Delete the managed install, node home, service, cache, and Linux system user/group.
`help`	Show script help.

install and state-sync also set [evm] evm-chain-id in app.toml from the chain ID: 8 on mainnet (c8ntinuum_8-1), 8888 on testnet (c8ntinuum_8888-1). For a chain ID with no number in it, set CTMD_EVM_CHAIN_ID to choose the value.

Release metadata

deploy.sh install reads release metadata from metadata.json. The script resolves .ctmd.latest_version, selects the platform artifact URL and SHA-256 URL for linux-amd64, linux-arm64, or darwin-arm64, downloads the tarball, verifies SHA-256, and installs the bundled binary and shared libraries. For mainnet, the script checks both the downloaded and the local genesis.json against the SHA-256 published at the URL in the metadata.json field genesis.mainnet.sha256_url (https://resources.c8ntinuum.io/mainnet/genesis.json.sha256). When install --chain-id uses a non-default chain ID, the script downloads the configured genesis URL but skips the mainnet SHA-256 check.

Peer list

deploy.sh uses the hosted peer list at:

https://resources.c8ntinuum.io/peers.json

The peer list is the deployment source for network bootstrap information:

Key	Used for
`seeds`	Initial P2P discovery.
`persistent_peers`	Stable peers for joining and staying connected to the network. `deploy.sh state-sync` also uses the first two hosts as state-sync snapshot peers.
`trusted_rpcs`	Trusted RPC endpoints used to compute state-sync trust height and hash. `deploy.sh state-sync` uses the first two.

deploy.sh state-sync needs at least two trusted_rpcs entries for the network unless both --rpc-1 and --rpc-2 are given, and at least two persistent_peers entries unless both --p2p-host-1 and --p2p-host-2 are given. deploy.sh selects peer-list entries by chain ID, so node deployers normally do not need to manually copy a peer list into config.toml. Operators using private infrastructure can override RPC and snapshot peer hosts with deploy.sh state-sync flags such as --rpc-1, --rpc-2, --p2p-host-1, and --p2p-host-2.

Local node script

local_node.sh ships with the ctmd source, which will be published in a public GitHub repository; the repository is to be announced. From a checkout of that repository, start a local developer chain:

./local_node.sh -y

Introduction

Developer Essentials

Tooling and Infrastructure

Reference

Guides

Resources

Canonical resources

Deploy script

Release metadata

Peer list

Local node script

​Canonical resources

​Deploy script

​Release metadata

​Peer list

​Local node script

Canonical resources

Deploy script

Release metadata

Peer list

Local node script