Skip to content
Algorand Developer Portal Algorand Developer Portal Algorand Developer Portal
This new developer portal is under construction. For complete documentation, please refer to the old developer portal.

nodekit

Synopsis

Manage Algorand nodes from the command line

Overview:
Welcome to NodeKit, a TUI for managing Algorand nodes.
A one stop shop for managing Algorand nodes, including node creation, configuration, and management.

Note: This is still a work in progress. Expect bugs and rough edges.

1
nodekit [flags]

Options

1
  -d, --datadir string   Data directory for the node
2
  -h, --help             help for nodekit
3
  -n, --no-incentives    Disable setting incentive eligibility fees

Commands

bootstrap

Initialize a fresh node

Overview:
Get up and running with a fresh Algorand node.
Uses the local package manager to install Algorand, and then starts the node and preforms a Fast-Catchup.

Note: This command only supports the default data directory, /var/lib/algorand

1
nodekit bootstrap [flags]

Options

1
  -h, --help   help for bootstrap

catchup

Fast-Catchup is a feature that allows your node to catch up to the network faster than normal.

Overview:
The entire process should sync a node in minutes rather than hours or days.
Actual sync times may vary depending on the number of accounts, number of blocks and the network.

Note: Not all networks support Fast-Catchup.

1
nodekit catchup [flags]

Options

1
  -d, --datadir string   Data directory for the node
2
  -h, --help             help for catchup

catchup debug

Display debug information for Fast-Catchup.

Overview:
This information is useful for debugging fast-catchup issues.

Note: Not all networks support Fast-Catchup.

1
nodekit catchup debug [flags]

Options

1
  -d, --datadir string   Data directory for the node
2
  -h, --help             help for debug

catchup start

Catchup the node to the latest catchpoint.

Overview:
Starting a catchup will sync the node to the latest catchpoint.
Actual sync times may vary depending on the number of accounts, number of blocks and the network.

Note: Not all networks support Fast-Catchup.

1
nodekit catchup start [flags]

Options

1
  -d, --datadir string   Data directory for the node
2
  -h, --help             help for start

catchup stop

Stop a fast catchup

Overview:
Stop an active Fast-Catchup. This will abort the catchup process if one has started

Note: Not all networks support Fast-Catchup.

1
nodekit catchup stop [flags]

Options

1
  -d, --datadir string   Data directory for the node
2
  -h, --help             help for stop

configure

Change settings on the system (WIP)

Overview:
Tool for inspecting and updating the Algorand daemon’s config.json and service files

Note: This is still a work in progress. Expect bugs and rough edges.

Options

1
  -h, --help   help for configure

configure service

Install service files for the Algorand daemon.

Overview:
Ensuring that the Algorand daemon is installed and running as a service.

Note: This is still a work in progress. Expect bugs and rough edges.

1
nodekit configure service [flags]

Options

1
  -h, --help   help for service

debug

Display debugging information

Overview:
Prints the known state of the nodekit
Checks various paths and configurations to present useful information for bug reports.

1
nodekit debug [flags]

Options

1
  -d, --datadir string   Data directory for the node
2
  -h, --help             help for debug

install

Install the node daemon

Overview:
Configures the local package manager and installs the algorand daemon on your local machine

1
nodekit install [flags]

Options

1
  -f, --force   forcefully install the node
2
  -h, --help    help for install

start

Start the node daemon

Overview:
Start the Algorand daemon on your local machine if it is not already running. Optionally, the daemon can be forcefully started.

This requires the daemon to be installed on your system.

1
nodekit start [flags]

Options

1
  -f, --force   forcefully start the node
2
  -h, --help    help for start

stop

Stop the node daemon

Overview:
Stops the Algorand daemon on your local machine. Optionally, the daemon can be forcefully stopped.

This requires the daemon to be installed on your system.

1
nodekit stop [flags]

Options

1
  -f, --force   forcefully stop the node
2
  -h, --help    help for stop

uninstall

Uninstall the node daemon

Overview:
Uninstall Algorand node (Algod) and other binaries on your system installed by this tool.

This requires the daemon to be installed on your system.

1
nodekit uninstall [flags]

Options

1
  -f, --force   forcefully uninstall the node
2
  -h, --help    help for uninstall

upgrade

Upgrade the node daemon

Overview:
Upgrade Algorand packages if it was installed with package manager.

This requires the daemon to be installed on your system.

1
nodekit upgrade [flags]

Options

1
  -h, --help   help for upgrade
Auto generated by spf13/cobra on 28-Jan-2025