Skip to content

Commit

Permalink
Merge pull request #141 from algorandfoundation/chore/refactor-docume…
Browse files Browse the repository at this point in the history
…ntation

chore: remove temporary documentation
  • Loading branch information
PhearZero authored Feb 10, 2025
2 parents 8890f4c + b5a001b commit afd14b6
Show file tree
Hide file tree
Showing 57 changed files with 454 additions and 793 deletions.
295 changes: 295 additions & 0 deletions .devportal/nodekit.md
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
1 change: 0 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,6 @@ nodekit [flags]
* [nodekit uninstall](/man/nodekit_uninstall.md) - Uninstall the node daemon
* [nodekit upgrade](/man/nodekit_upgrade.md) - Upgrade the node daemon

###### Auto generated by spf13/cobra on 22-Jan-2025

### Installing

Expand Down
23 changes: 0 additions & 23 deletions docs/astro.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -18,29 +18,6 @@ export default defineConfig({
social: {
github: "https://github.com/algorandfoundation/nodekit",
},
sidebar: [
{
label: "Guides",
autogenerate: { directory: "guides" },
},
{
label: "Command Reference",
collapsed: true,
autogenerate: { directory: "reference" },
},
{
label: "Source Code",
link: "https://github.com/algorandfoundation/nodekit/",
},
{
label: "Issue Tracker",
link: "https://github.com/algorandfoundation/nodekit/issues",
},
{
label: "Report an issue",
link: "https://github.com/algorandfoundation/nodekit/issues/new/choose",
}
],
components: {
ThemeProvider: "./src/components/CustomThemeProvider.astro",
},
Expand Down
Binary file removed docs/public/assets/lora-keyreg.png
Binary file not shown.
Binary file removed docs/public/assets/lora-txn-ok.png
Binary file not shown.
Binary file removed docs/public/assets/nodekit-bootstrap.png
Binary file not shown.
Binary file removed docs/public/assets/nodekit-error-keygen-already.png
Binary file not shown.
Binary file removed docs/public/assets/nodekit-error-keygen-failed.png
Binary file not shown.
Binary file removed docs/public/assets/nodekit-fast-catchup.png
Binary file not shown.
Binary file removed docs/public/assets/nodekit-install.png
Binary file not shown.
Binary file removed docs/public/assets/nodekit-key-info.png
Binary file not shown.
Binary file removed docs/public/assets/nodekit-keyreg-online.png
Binary file not shown.
Binary file removed docs/public/assets/nodekit-keyreg-success.png
Binary file not shown.
Binary file removed docs/public/assets/nodekit-navigate-accounts.gif
Binary file not shown.
Binary file removed docs/public/assets/nodekit-navigate-keys.gif
Binary file not shown.
Binary file removed docs/public/assets/nodekit-partkey-gen-1.png
Binary file not shown.
Binary file removed docs/public/assets/nodekit-partkey-gen-2.png
Binary file not shown.
Binary file removed docs/public/assets/nodekit-partkey-gen-3.png
Binary file not shown.
Binary file removed docs/public/assets/nodekit-partkey-gen-4.png
Binary file not shown.
Binary file removed docs/public/assets/nodekit-state-fast-catchup.png
Binary file not shown.
Binary file removed docs/public/assets/nodekit-state-running.png
Binary file not shown.
Binary file removed docs/public/assets/nodekit-state-syncing.png
Binary file not shown.
Binary file removed docs/public/assets/note-protocol-voting.png
Binary file not shown.
7 changes: 0 additions & 7 deletions docs/src/content.config.ts

This file was deleted.

Loading

0 comments on commit afd14b6

Please sign in to comment.