Skip to content

Node Management

The node command group allows you to list, register, stake, and manage network nodes on the Aleph Cloud network. For node registration and staking, see aleph node --help.

Overall Usage

bash
aleph node [OPTIONS] COMMAND [ARGS]...

Options

OptionDescription
--jsonOutput results as JSON
--helpShow this message and exit

Key Commands

CommandDescription
listList nodes on the network
create-ccnRegister a new Core Channel Node (CCN)
create-crnRegister a new Compute Resource Node (CRN)
amendAmend metadata fields on an existing node
stakeStake ALEPH tokens on a node
unstakeRemove your stake from a node
linkLink a CRN to one of your CCNs
unlinkUnlink a CRN from your CCN
dropRemove a node from the network

List Nodes

List nodes on the network. Use --type to filter by node type.

Usage

bash
aleph node list [OPTIONS]

Options

OptionDescription
--type <TYPE>Filter by node type: ccn (Core Channel Node) or crn (Compute Resource Node)
--address <ADDR>Filter by owner address
--allList all nodes on the network
--corechannel-address <ADDR>Address of the corechannel aggregate owner (defaults to mainnet)
--jsonOutput results as JSON
--account <ACCOUNT>Named account (defaults to the active account)
--private-key <KEY>Hex-encoded private key
--chain <CHAIN>Signing chain
--helpShow this message and exit
bash
# List all Compute Resource Nodes (CRN) in JSON format
aleph node list --type crn --json

# List all Core Channel Nodes (CCN)
aleph node list --type ccn

# List all nodes on the network
aleph node list --all

# List CRNs filtered by owner address
aleph node list --type crn --address ADDRESS

# List CCNs filtered by owner address
aleph node list --type ccn --address ADDRESS