Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kusamaxi/polkacli
Bash tool for easy installation of polkadot node for Kusama, Polkadot and Westend networks.
https://github.com/kusamaxi/polkacli
Last synced: 3 months ago
JSON representation
Bash tool for easy installation of polkadot node for Kusama, Polkadot and Westend networks.
- Host: GitHub
- URL: https://github.com/kusamaxi/polkacli
- Owner: kusamaxi
- Created: 2021-05-07T14:23:51.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-03-19T20:30:47.000Z (almost 2 years ago)
- Last Synced: 2024-08-02T19:33:16.611Z (6 months ago)
- Size: 83 KB
- Stars: 6
- Watchers: 2
- Forks: 0
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-dot - Polkacli - Bash tool for easy installation and running of Kusama nodes. (Resources / Tools)
README
# polkacli
Simple bash aliases for easy installation of polkadot node for Kusama network.
## Requirements
1. Add new user, set password, add sudo rights and login to that user
```
adduser kusama
passwd kusama
usermod -aG sudo kusama # Ubuntu/Debian
usermod -aG wheel kusama # Centos/Rocky
su kusama && cd ~
```
2. Once logged in to user running node, install lz4, curl, git, jq, micro, tar and wget
```
# if ubuntu/debian
sudo apt-get install -y curl git lz4 jq tar wget &&
curl https://getmic.ro | GETMICRO_REGISTER=y sudo sh &&
sudo cp micro /usr/local/bin && sudo mv micro /usr/sbin
# if centos/rocky
sudo yum install -y curl git lz4 jq tar wget &&
curl https://getmic.ro | GETMICRO_REGISTER=y sudo sh &&
sudo cp micro /usr/local/bin && sudo mv micro /usr/sbin
```
## Install polkacli
```
git clone https://github.com/kusamaxi/polkacli ~/polkacli &&
mv ~/polkacli/.polkacli ~/ && rm -rf ~/polkacli &&
echo "# source polkacli
. ~/.polkacli" >> ~/.bashrc &&
. ~/.bashrc
```
## create .service file
edit
-->
```
[Unit]
Description= $NETWORK Validator - $NODE_NAME
[Service]
User=kusama
Group=kusama
WorkingDirectory=/usr/local/bin/
ExecStart=/usr/local/bin/polkadot \
--database=RocksDb \
--pruning 1000 --chain $NETWORK --validator \
--telemetry-url 'wss://telemetry-backend.w3f.community/submit 1' \
--port 30333 --ws-port 9944 --rpc-port 9933 --name "$NODE_NAME"
Restart=always
RestartSec=120
[Install]
WantedBy=multi-user.target
```
## download client, download database and start your node
reload
download
shotdl
shotupdate
shotdel
update
--> node should be running
logsnow # to see whats going on .
## Commands
### Validator service
- **edit** = Edit the validator service with micro terminal
- **stop** = Stop the validator service
- **start** = Start the validator service
- **enable** = Enable the validator service to be booted on startup
- **disable** = Disable the validator service not to be booted on startup
- **status** = Check the status of the validator
- **reload** = Reload the daemon after changes made in the service
- **restart** = Restart the validator service
### Logs
- **logsnow** = Shows realtime logs
- **logs** = Shows last 1000 logs
### Updating polkadot client
- **version** = Shows your polkadot client version
- **download** = Download latest polkadot client from github, give execution rights and name it polkadot_latest
- **update** = Stop node, update client, start node
- **scriptupdate** = Updates the latest version of the script
### Fast sync with polkashots using rocksdb
- **shotdl** = Download latest polkashot
- **shotupdate** = Stop the node & delete old database & extract new database & start the node
- **shotdel** = Delete downloaded database
### RPC-commands(advanced - be careful)
- **rotatekeys** = Rotates your Validator node sessionkey, prints and appends the new sessionkey to sessionkeys.log
- **epochauthorship** = command to check if your node is active block producer
## Coming up next
- Create installer script including options to install for parachains
- Add secure firewall setup
- Add secure SSH ruling
- Create proper CLI tool instead of bashing with aliases
- Make script to support CentOS / Ubuntu