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