-
Notifications
You must be signed in to change notification settings - Fork 7
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #141 from algorandfoundation/chore/refactor-docume…
…ntation chore: remove temporary documentation
- Loading branch information
Showing
57 changed files
with
454 additions
and
793 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,295 @@ | ||
--- | ||
title: "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. | ||
|
||
``` | ||
nodekit [flags] | ||
``` | ||
|
||
### Options | ||
|
||
``` | ||
-d, --datadir string Data directory for the node | ||
-h, --help help for nodekit | ||
-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 | ||
|
||
``` | ||
nodekit bootstrap [flags] | ||
``` | ||
|
||
#### Options | ||
|
||
``` | ||
-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. | ||
|
||
``` | ||
nodekit catchup [flags] | ||
``` | ||
|
||
#### Options | ||
|
||
``` | ||
-d, --datadir string Data directory for the node | ||
-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. | ||
|
||
``` | ||
nodekit catchup debug [flags] | ||
``` | ||
|
||
#### Options | ||
|
||
``` | ||
-d, --datadir string Data directory for the node | ||
-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. | ||
|
||
``` | ||
nodekit catchup start [flags] | ||
``` | ||
|
||
#### Options | ||
|
||
``` | ||
-d, --datadir string Data directory for the node | ||
-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. | ||
|
||
``` | ||
nodekit catchup stop [flags] | ||
``` | ||
|
||
#### Options | ||
|
||
``` | ||
-d, --datadir string Data directory for the node | ||
-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 | ||
|
||
``` | ||
-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. | ||
|
||
``` | ||
nodekit configure service [flags] | ||
``` | ||
|
||
#### Options | ||
|
||
``` | ||
-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. | ||
|
||
|
||
``` | ||
nodekit debug [flags] | ||
``` | ||
|
||
#### Options | ||
|
||
``` | ||
-d, --datadir string Data directory for the node | ||
-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 | ||
|
||
|
||
``` | ||
nodekit install [flags] | ||
``` | ||
|
||
#### Options | ||
|
||
``` | ||
-f, --force forcefully install the node | ||
-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. | ||
|
||
``` | ||
nodekit start [flags] | ||
``` | ||
|
||
#### Options | ||
|
||
``` | ||
-f, --force forcefully start the node | ||
-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. | ||
|
||
``` | ||
nodekit stop [flags] | ||
``` | ||
|
||
#### Options | ||
|
||
``` | ||
-f, --force forcefully stop the node | ||
-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. | ||
|
||
``` | ||
nodekit uninstall [flags] | ||
``` | ||
|
||
#### Options | ||
|
||
``` | ||
-f, --force forcefully uninstall the node | ||
-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. | ||
|
||
``` | ||
nodekit upgrade [flags] | ||
``` | ||
|
||
#### Options | ||
|
||
``` | ||
-h, --help help for upgrade | ||
``` | ||
|
||
###### Auto generated by spf13/cobra on 28-Jan-2025 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
This file was deleted.
Oops, something went wrong.
Oops, something went wrong.