# node · Chromia Docs (concept)

> The node command (pmc node) consists of sub-commands used to manage nodes.

Source: https://docs.chromia.com/ecosystem/providers/pmc/commands/node/

# node

On this page

* [node register](#node-register)
* [node register-replica](#node-register-replica)
* [node update](#node-update)
* [node replace](#node-replace)
* [node disable](#node-disable)
* [node enable](#node-enable)
* [node remove](#node-remove)
* [node remove from cluster](#node-remove-from-cluster)
* [node info](#node-info)
* [node verify](#node-verify)
* [node blockchains](#node-blockchains)
* [node containers](#node-containers)
* [node list](#node-list)
* [node ping](#node-ping)
* [node check-cluster-removal-status](#node-check-cluster-removal-status)

Plain text

```
Usage: pmc node [OPTIONS] COMMAND [ARGS]...

  Node commands

╭─ Options ───────────────────────────────────────────────────────────────────╮
│  -h, --help  Show this message and exit                                     │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ──────────────────────────────────────────────────────────────────╮
│  register                      Registers a node                             │
│  register-replica              Registers a replica node                     │
│  update                        Update node information                      │
│  replace                       Replace a node with a new one (used to rotate│
│                                keypairs)                                    │
│  disable                       Disables node and removes it from clusters,  │
│                                cluster replicas, blockchain replicas        │
│  enable                        Enables node                                 │
│  remove                        Removes disabled node                        │
│  remove-from-cluster           Removes node from a specific cluster         │
│  info                          Get node info for given node pubkey          │
│  verify                        Verify node status                           │
│  blockchains                   List blockchains for node                    │
│  containers                    List containers for node                     │
│  list                          List all nodes, optionally filtered by       │
│                                cluster                                      │
│  ping                          Check if a node is accessible                │
│  check-cluster-removal-status  Checks if a node has been successfully       │
│                                removed from a cluster                       │
╰─────────────────────────────────────────────────────────────────────────────╯
```

The node command (`pmc node`) consists of sub-commands used to manage nodes.

## node register

To register a node, use the (`pmc node register`) command.

Plain text

```
Usage: pmc node register [OPTIONS]

  Registers a node

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│  -cfg, --config=CONFIG    Alternate path for client configuration file      │
│  -s, --settings=SETTINGS  Alternate path for project settings file          │
│  --lookup-brid            Ignore any 'brid' property in configuration file, │
│                           always perform lookup                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
│  --secret=PATH            Path to secret file (pubkey/privkey)              │
│  --key-id=KEY_ID          Key ID of the keypair to use                      │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Signers, leave out this option to send transaction directly ───────────────╮
│  --signer=VALUE       Public keys of signer (can be repeated)               │
│  --signers=VALUE      Comma separated list of keys of signers               │
│  --signers-file=PATH  Path to file containing public keys of signers, one   │
│                       per line                                              │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│  --timeb-at=VALUE           Add timeb operation to make transaction fail if │
│                             applied after the given time (UTC). Supported   │
│                             formats: yyyy-MM-dd HH:mm, yyyy-MM-dd'T'HH:mm   │
│                             and milliseconds since 1970 (unix/epoch time)   │
│  --timeb-after=VALUE        Add timeb operation to make transaction fail if │
│                             applied after the given number of seconds from  │
│                             now.                                            │
│  --save-tx                  Always save transaction to file, even if it is  │
│                             fully signed                                    │
│  --target=PATH              Path where transaction file should be saved     │
│                             (default: /opt/chromaway/postchain)             │
│* -pk, --pubkey=PUBKEY       Node pubkey                                     │
│* --host=TEXT                Host                                            │
│* -p, --port=INT             Port                                            │
│* -a, --api-url=TEXT         api url                                         │
│* -t, --territory=TEXT       ISO 3166-1 alpha-2 code                         │
│  -clu, --cluster-units=INT  Cluster Units (minimum 1) (default: 1)          │
│  -es, --extra-storage=INT   Extra Storage (MiB) (default: 0)                │
│  -c, --cluster=TEXT         Comma delimited list of clusters this node      │
│                             belongs to (default: [])                        │
│  --disable-access-checks    Disable node and REST API access checks         │
│  -h, --help                 Show this message and exit                      │
╰─────────────────────────────────────────────────────────────────────────────╯
```

The register command (`pmc node register`) registers a node to one or several clusters in the network. You have to
provide information about the nodes `pubkey`, `api-url`, `host`, and `port` where the node is hosted and the clusters to
which the node belongs. `host` is your static IP (please note that the same IP should also be used in the `api-url`).

* To register a node to a cluster, use the following:

Terminal

```
pmc node register --pubkey <node-pub-key> --host <ip> -port 9870 --api-url <https://<ip>> --cluster <example-cluster>
```

## node register-replica

Plain text

```
Usage: pmc node register-replica [OPTIONS]

  Registers a replica node

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│  -cfg, --config=CONFIG    Alternate path for client configuration file      │
│  -s, --settings=SETTINGS  Alternate path for project settings file          │
│  --lookup-brid            Ignore any 'brid' property in configuration file, │
│                           always perform lookup                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
│  --secret=PATH            Path to secret file (pubkey/privkey)              │
│  --key-id=KEY_ID          Key ID of the keypair to use                      │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Signers, leave out this option to send transaction directly ───────────────╮
│  --signer=VALUE       Public keys of signer (can be repeated)               │
│  --signers=VALUE      Comma separated list of keys of signers               │
│  --signers-file=PATH  Path to file containing public keys of signers, one   │
│                       per line                                              │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│  --timeb-at=VALUE      Add timeb operation to make transaction fail if      │
│                        applied after the given time (UTC). Supported        │
│                        formats: yyyy-MM-dd HH:mm, yyyy-MM-dd'T'HH:mm and    │
│                        milliseconds since 1970 (unix/epoch time)            │
│  --timeb-after=VALUE   Add timeb operation to make transaction fail if      │
│                        applied after the given number of seconds from now.  │
│  --save-tx             Always save transaction to file, even if it is fully │
│                        signed                                               │
│  --target=PATH         Path where transaction file should be saved (default:│
│                        /opt/chromaway/postchain)                            │
│* -pk, --pubkey=PUBKEY  Node pubkey                                          │
│  --host=TEXT           Host                                                 │
│  -p, --port=INT        Port (default: 0)                                    │
│  -a, --api-url=TEXT    api url                                              │
│  -t, --territory=TEXT  ISO 3166-1 alpha-2 code                              │
│  -h, --help            Show this message and exit                           │
╰─────────────────────────────────────────────────────────────────────────────╯
```

The register-replica command (`pmc node register-replica`) registers a replica node.

## node update

Plain text

```
Usage: pmc node update [OPTIONS]

  Update node information

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│  -cfg, --config=CONFIG    Alternate path for client configuration file      │
│  -s, --settings=SETTINGS  Alternate path for project settings file          │
│  --lookup-brid            Ignore any 'brid' property in configuration file, │
│                           always perform lookup                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
│  --secret=PATH            Path to secret file (pubkey/privkey)              │
│  --key-id=KEY_ID          Key ID of the keypair to use                      │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Signers, leave out this option to send transaction directly ───────────────╮
│  --signer=VALUE       Public keys of signer (can be repeated)               │
│  --signers=VALUE      Comma separated list of keys of signers               │
│  --signers-file=PATH  Path to file containing public keys of signers, one   │
│                       per line                                              │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│  --timeb-at=VALUE           Add timeb operation to make transaction fail if │
│                             applied after the given time (UTC). Supported   │
│                             formats: yyyy-MM-dd HH:mm, yyyy-MM-dd'T'HH:mm   │
│                             and milliseconds since 1970 (unix/epoch time)   │
│  --timeb-after=VALUE        Add timeb operation to make transaction fail if │
│                             applied after the given number of seconds from  │
│                             now.                                            │
│  --save-tx                  Always save transaction to file, even if it is  │
│                             fully signed                                    │
│  --target=PATH              Path where transaction file should be saved     │
│                             (default: /opt/chromaway/postchain)             │
│* -pk, --pubkey=PUBKEY       Public key                                      │
│  --host=TEXT                Host                                            │
│  -p, --port=INT             Port                                            │
│  -a, --api-url=TEXT         api url                                         │
│  -t, --territory=TEXT       ISO 3166-1 alpha-2 code                         │
│  -clu, --cluster-units=INT  Cluster Units (minimum 1)                       │
│  -es, --extra-storage=INT   Extra Storage (MiB)                             │
│  -c, --cluster=TEXT         Comma delimited list of clusters to add this    │
│                             node to                                         │
│  -h, --help                 Show this message and exit                      │
╰─────────────────────────────────────────────────────────────────────────────╯
```

The update command (`pmc node update`) updates information regarding the node to the network.

Example usage:

Terminal

```
pmc node update --api-url https://node0-delta.chromia.dev --pubkey 000000000
```

note

Using port 443 (standard HTTPS port) is recommended. Port 7740 can also be used as an alternative.

## node replace

Plain text

```
Usage: pmc node replace [OPTIONS]

  Replace a node with a new one (used to rotate keypairs)

  Add the keys to the nodes to the client configuration as comma-delimited
  list: pubkey=<key>,<old-node-key>,<new-node-key>
  privkey=<key>,<old-node-key>,<new-node-key>

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│  -cfg, --config=CONFIG    Alternate path for client configuration file      │
│  -s, --settings=SETTINGS  Alternate path for project settings file          │
│  --lookup-brid            Ignore any 'brid' property in configuration file, │
│                           always perform lookup                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
│  --secret=PATH            Path to secret file (pubkey/privkey)              │
│  --key-id=KEY_ID          Key ID of the keypair to use                      │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Signers, leave out this option to send transaction directly ───────────────╮
│  --signer=VALUE       Public keys of signer (can be repeated)               │
│  --signers=VALUE      Comma separated list of keys of signers               │
│  --signers-file=PATH  Path to file containing public keys of signers, one   │
│                       per line                                              │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│  --timeb-at=VALUE           Add timeb operation to make transaction fail if │
│                             applied after the given time (UTC). Supported   │
│                             formats: yyyy-MM-dd HH:mm, yyyy-MM-dd'T'HH:mm   │
│                             and milliseconds since 1970 (unix/epoch time)   │
│  --timeb-after=VALUE        Add timeb operation to make transaction fail if │
│                             applied after the given number of seconds from  │
│                             now.                                            │
│  --save-tx                  Always save transaction to file, even if it is  │
│                             fully signed                                    │
│  --target=PATH              Path where transaction file should be saved     │
│                             (default: /opt/chromaway/postchain)             │
│* --old-key=VALUE            Public key of the node to replace               │
│* --new-key=VALUE            Public key of the new node                      │
│  --host=TEXT                Host                                            │
│  -p, --port=INT             Port                                            │
│  -a, --api-url=TEXT         api url                                         │
│  -t, --territory=TEXT       ISO 3166-1 alpha-2 code                         │
│  -clu, --cluster-units=INT  Cluster Units (minimum 1)                       │
│  -es, --extra-storage=INT   Extra Storage (MiB)                             │
│  --keep-as-replica          Keep replaced node as a replica node            │
│  -h, --help                 Show this message and exit                      │
╰─────────────────────────────────────────────────────────────────────────────╯
```

The replace command (`pmc node replace`) replaces a node given by its public key with a new node. It adds the keys to
the nodes in the configuration.

Example usage:

Terminal

```
pmc node replace --old-key 00000D --new-key 00008
```

## node disable

Plain text

```
Usage: pmc node disable [OPTIONS]

  Disables node and removes it from clusters, cluster replicas, blockchain
  replicas

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│  -cfg, --config=CONFIG    Alternate path for client configuration file      │
│  -s, --settings=SETTINGS  Alternate path for project settings file          │
│  --lookup-brid            Ignore any 'brid' property in configuration file, │
│                           always perform lookup                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
│  --secret=PATH            Path to secret file (pubkey/privkey)              │
│  --key-id=KEY_ID          Key ID of the keypair to use                      │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Signers, leave out this option to send transaction directly ───────────────╮
│  --signer=VALUE       Public keys of signer (can be repeated)               │
│  --signers=VALUE      Comma separated list of keys of signers               │
│  --signers-file=PATH  Path to file containing public keys of signers, one   │
│                       per line                                              │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│  --timeb-at=VALUE      Add timeb operation to make transaction fail if      │
│                        applied after the given time (UTC). Supported        │
│                        formats: yyyy-MM-dd HH:mm, yyyy-MM-dd'T'HH:mm and    │
│                        milliseconds since 1970 (unix/epoch time)            │
│  --timeb-after=VALUE   Add timeb operation to make transaction fail if      │
│                        applied after the given number of seconds from now.  │
│  --save-tx             Always save transaction to file, even if it is fully │
│                        signed                                               │
│  --target=PATH         Path where transaction file should be saved (default:│
│                        /opt/chromaway/postchain)                            │
│* -pk, --pubkey=PUBKEY  Public key                                           │
│  -h, --help            Show this message and exit                           │
╰─────────────────────────────────────────────────────────────────────────────╯
```

The disable command (`pmc node disable`) disables a node and removes it from clusters as well as cluster and blockchain
replicas.

## node enable

Plain text

```
Usage: pmc node enable [OPTIONS]

  Enables node

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│  -cfg, --config=CONFIG    Alternate path for client configuration file      │
│  -s, --settings=SETTINGS  Alternate path for project settings file          │
│  --lookup-brid            Ignore any 'brid' property in configuration file, │
│                           always perform lookup                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
│  --secret=PATH            Path to secret file (pubkey/privkey)              │
│  --key-id=KEY_ID          Key ID of the keypair to use                      │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Signers, leave out this option to send transaction directly ───────────────╮
│  --signer=VALUE       Public keys of signer (can be repeated)               │
│  --signers=VALUE      Comma separated list of keys of signers               │
│  --signers-file=PATH  Path to file containing public keys of signers, one   │
│                       per line                                              │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│  --timeb-at=VALUE      Add timeb operation to make transaction fail if      │
│                        applied after the given time (UTC). Supported        │
│                        formats: yyyy-MM-dd HH:mm, yyyy-MM-dd'T'HH:mm and    │
│                        milliseconds since 1970 (unix/epoch time)            │
│  --timeb-after=VALUE   Add timeb operation to make transaction fail if      │
│                        applied after the given number of seconds from now.  │
│  --save-tx             Always save transaction to file, even if it is fully │
│                        signed                                               │
│  --target=PATH         Path where transaction file should be saved (default:│
│                        /opt/chromaway/postchain)                            │
│* -pk, --pubkey=PUBKEY  Public key                                           │
│  -h, --help            Show this message and exit                           │
╰─────────────────────────────────────────────────────────────────────────────╯
```

The enable command (`pmc node enable`) enables a disabled node.

## node remove

Plain text

```
Usage: pmc node remove [OPTIONS]

  Removes disabled node

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│  -cfg, --config=CONFIG    Alternate path for client configuration file      │
│  -s, --settings=SETTINGS  Alternate path for project settings file          │
│  --lookup-brid            Ignore any 'brid' property in configuration file, │
│                           always perform lookup                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
│  --secret=PATH            Path to secret file (pubkey/privkey)              │
│  --key-id=KEY_ID          Key ID of the keypair to use                      │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Signers, leave out this option to send transaction directly ───────────────╮
│  --signer=VALUE       Public keys of signer (can be repeated)               │
│  --signers=VALUE      Comma separated list of keys of signers               │
│  --signers-file=PATH  Path to file containing public keys of signers, one   │
│                       per line                                              │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│  --timeb-at=VALUE      Add timeb operation to make transaction fail if      │
│                        applied after the given time (UTC). Supported        │
│                        formats: yyyy-MM-dd HH:mm, yyyy-MM-dd'T'HH:mm and    │
│                        milliseconds since 1970 (unix/epoch time)            │
│  --timeb-after=VALUE   Add timeb operation to make transaction fail if      │
│                        applied after the given number of seconds from now.  │
│  --save-tx             Always save transaction to file, even if it is fully │
│                        signed                                               │
│  --target=PATH         Path where transaction file should be saved (default:│
│                        /opt/chromaway/postchain)                            │
│* -pk, --pubkey=PUBKEY  Public key                                           │
│  -h, --help            Show this message and exit                           │
╰─────────────────────────────────────────────────────────────────────────────╯
```

The remove command (`pmc node remove`) removes a node from a network. The node has to be disabled (`pmc node disable`)
before it can be removed.

## node remove from cluster

Plain text

```
Usage: pmc node remove-from-cluster [OPTIONS]

  Removes node from a specific cluster

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│  -cfg, --config=CONFIG    Alternate path for client configuration file      │
│  -s, --settings=SETTINGS  Alternate path for project settings file          │
│  --lookup-brid            Ignore any 'brid' property in configuration file, │
│                           always perform lookup                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
│  --secret=PATH            Path to secret file (pubkey/privkey)              │
│  --key-id=KEY_ID          Key ID of the keypair to use                      │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Signers, leave out this option to send transaction directly ───────────────╮
│  --signer=VALUE       Public keys of signer (can be repeated)               │
│  --signers=VALUE      Comma separated list of keys of signers               │
│  --signers-file=PATH  Path to file containing public keys of signers, one   │
│                       per line                                              │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│  --timeb-at=VALUE      Add timeb operation to make transaction fail if      │
│                        applied after the given time (UTC). Supported        │
│                        formats: yyyy-MM-dd HH:mm, yyyy-MM-dd'T'HH:mm and    │
│                        milliseconds since 1970 (unix/epoch time)            │
│  --timeb-after=VALUE   Add timeb operation to make transaction fail if      │
│                        applied after the given number of seconds from now.  │
│  --save-tx             Always save transaction to file, even if it is fully │
│                        signed                                               │
│  --target=PATH         Path where transaction file should be saved (default:│
│                        /opt/chromaway/postchain)                            │
│* -pk, --pubkey=PUBKEY  Public key                                           │
│* -c, --cluster=TEXT    Name of cluster to remove the node from              │
│  -h, --help            Show this message and exit                           │
╰─────────────────────────────────────────────────────────────────────────────╯
```

The remove from cluster command (`pmc node remove-from-cluster`) removes a node from a cluster. The command will not disable the node or remove it entirely.

## node info

Plain text

```
Usage: pmc node info [OPTIONS]

  Get node info for given node pubkey

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│  -cfg, --config=CONFIG    Alternate path for client configuration file      │
│  -s, --settings=SETTINGS  Alternate path for project settings file          │
│  --lookup-brid            Ignore any 'brid' property in configuration file, │
│                           always perform lookup                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│* -pk, --pubkey=PUBKEY  Public key                                           │
│  -h, --help            Show this message and exit                           │
╰─────────────────────────────────────────────────────────────────────────────╯
```

The info command (`pmc node info`) shows information about a given node by its public key.

Example usage:

Terminal

```
pmc node info --pubkey 0000B
```

## node verify

Plain text

```
Usage: pmc node verify [OPTIONS]

  Verify node status

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│  -cfg, --config=CONFIG    Alternate path for client configuration file      │
│  -s, --settings=SETTINGS  Alternate path for project settings file          │
│  --lookup-brid            Ignore any 'brid' property in configuration file, │
│                           always perform lookup                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│* -pk, --pubkey=PUBKEY  Public key                                           │
│  -h, --help            Show this message and exit                           │
╰─────────────────────────────────────────────────────────────────────────────╯
```

The verify command (`pmc node verify`) verifies the status of a specific node identified by its public key.

## node blockchains

Plain text

```
Usage: pmc node blockchains [OPTIONS]

  List blockchains for node

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│  -cfg, --config=CONFIG    Alternate path for client configuration file      │
│  -s, --settings=SETTINGS  Alternate path for project settings file          │
│  --lookup-brid            Ignore any 'brid' property in configuration file, │
│                           always perform lookup                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│* -pk, --pubkey=PUBKEY  Public key                                           │
│  -h, --help            Show this message and exit                           │
╰─────────────────────────────────────────────────────────────────────────────╯
```

The blockchains command (`pmc node blockchians`) lists blockchains running on a node.

## node containers

Plain text

```
Usage: pmc node containers [OPTIONS]

  List containers for node

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│  -cfg, --config=CONFIG    Alternate path for client configuration file      │
│  -s, --settings=SETTINGS  Alternate path for project settings file          │
│  --lookup-brid            Ignore any 'brid' property in configuration file, │
│                           always perform lookup                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│* -pk, --pubkey=PUBKEY  Public key                                           │
│  -h, --help            Show this message and exit                           │
╰─────────────────────────────────────────────────────────────────────────────╯
```

The containers command (`pmc node containers`) gives a list of containers the node is part of.

## node list

Plain text

```
Usage: pmc node list [OPTIONS]

  List all nodes, optionally filtered by cluster

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│  -cfg, --config=CONFIG    Alternate path for client configuration file      │
│  -s, --settings=SETTINGS  Alternate path for project settings file          │
│  --lookup-brid            Ignore any 'brid' property in configuration file, │
│                           always perform lookup                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│  -i, --interactive       Prompt for item to show details for                │
│  --cluster=CLUSTER_NAME  Only list nodes belonging to the given cluster     │
│  -h, --help              Show this message and exit                         │
╰─────────────────────────────────────────────────────────────────────────────╯
```

The list command (`pmc node list`) lists all nodes in the network.

## node ping

Plain text

```
Usage: pmc node ping [OPTIONS]

  Check if a node is accessible

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│  -cfg, --config=CONFIG    Alternate path for client configuration file      │
│  -s, --settings=SETTINGS  Alternate path for project settings file          │
│  --lookup-brid            Ignore any 'brid' property in configuration file, │
│                           always perform lookup                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│* --host=TEXT     Host                                                       │
│* -p, --port=INT  Port                                                       │
│  -h, --help      Show this message and exit                                 │
╰─────────────────────────────────────────────────────────────────────────────╯
```

The ping command (`pmc node ping`) pings a specific node to check its connectivity.

## node check-cluster-removal-status

Plain text

```
Usage: pmc node check-cluster-removal-status [OPTIONS]

  Checks if a node has been successfully removed from a cluster

╭─ Configuration Properties ──────────────────────────────────────────────────╮
│  -cfg, --config=CONFIG    Alternate path for client configuration file      │
│  -s, --settings=SETTINGS  Alternate path for project settings file          │
│  --lookup-brid            Ignore any 'brid' property in configuration file, │
│                           always perform lookup                             │
│  --lookup-nodes / --no-lookup-nodes                                         │
│                           Lookup system cluster signer nodes for sending    │
│                           transactions to (default: yes)                    │
│  --network=TEXT           Target network to make requests to (if chromia.yml│
│                           is configured)                                    │
│  --secret=PATH            Path to secret file (pubkey/privkey)              │
│  --key-id=KEY_ID          Key ID of the keypair to use                      │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Signers, leave out this option to send transaction directly ───────────────╮
│  --signer=VALUE       Public keys of signer (can be repeated)               │
│  --signers=VALUE      Comma separated list of keys of signers               │
│  --signers-file=PATH  Path to file containing public keys of signers, one   │
│                       per line                                              │
╰─────────────────────────────────────────────────────────────────────────────╯
╭─ Options ───────────────────────────────────────────────────────────────────╮
│  --timeb-at=VALUE      Add timeb operation to make transaction fail if      │
│                        applied after the given time (UTC). Supported        │
│                        formats: yyyy-MM-dd HH:mm, yyyy-MM-dd'T'HH:mm and    │
│                        milliseconds since 1970 (unix/epoch time)            │
│  --timeb-after=VALUE   Add timeb operation to make transaction fail if      │
│                        applied after the given number of seconds from now.  │
│  --save-tx             Always save transaction to file, even if it is fully │
│                        signed                                               │
│  --target=PATH         Path where transaction file should be saved (default:│
│                        /opt/chromaway/postchain)                            │
│* -pk, --pubkey=PUBKEY  Node pubkey                                          │
│* -c, --cluster=TEXT                                                         │
│  -h, --help            Show this message and exit                           │
╰─────────────────────────────────────────────────────────────────────────────╯
```

The check-cluster-removal-status command (`pmc node check-cluster-removal-status`) checks the status of cluster removal
for a node.

[View this page on docs.chromia.com](https://docs.chromia.com/ecosystem/providers/pmc/commands/node/)Content mirrored from the live docs
