Made with
curl -sL https://deb.nodesource.com/setup_9.x | sudo -E bash -
sudo apt-get install -y nodejs
sudo npm install pm2 -g
EOS.IO (nodeos) is required and expected to be installed in /home/ubuntu/eos/build/programs/nodeos
, if you installed in a different directory, please set the path to nodeos in the config.js
file before starting.
git clone https://github.com/igorls/eos-node-governor.git
cd eos-node-governor
npm install
Frontend will be automatically served from the precompiled files in frontend/dist
If you need to rebuild run:
cd frontend
npm install
npm run build
Close external access to the http api by setting http-server-address = 127.0.0.1:YOUR_PORT
api_port
-> public HTTP port for end usersnodeos_http_port
-> internal HTTP port defined on nodeos config.ini (http-server-address)secure_control_port
-> https port for remote control panelcontrol_port
-> unsecured control panel port, it's ignored ifsecure_control_port
is not 0
Define admin_user
and admin_pass
binary_path
-> path where the nodeos binary residesdata_path
-> path to store blocks and shared_mem foldersconfig_path
-> folder where your config.ini file is locatedlog_dir
-> folder for nodeos logslog_name
-> base name for the live log file
If a crash happens the governor will create a backup of the current log file suffixed by the crash time
The governor will automatically generate a self-signed certificate based on your machine public ip address, if you have a custom domain or already got a certificate, please set the full paths:
ssl_key
-> path to the .key filessl_cert
-> path to the .cert file
Leave them blank if you are fine with the self-signed certificate (it will show security warnings on the browser upon access, but you are still secured)
Check configurations on config.js
file before starting
First start with:
pm2 start ecosystem.config.js
To stop use:
pm2 stop ecosystem.config.js
To control only the eos-governor process use:
pm2 stop eos-governor
pm2 start eos-governor
pm2 reload eos-governor
avoid using pm2 restart ...
since it will corrupt your chain data!
sudo pm2 startup
By default all API's with exception of Net API (net_api_plugin) will be exposed to port 8888, as defined by default_config.api_port
Please open this port on your firewall instead of the nodeos http port
Test by pointing your browser to: http://your-node-address:8888/v1/chain/get_info
Access the control panel at: https://your-node-address:8443/
and login with the defined user and password