Docker should now be installed, the daemon started, and the process enabled to start on boot. Check that it’s running.
sudosystemctlstatusdocker
Using Docker
Run PostgreSQL
There are three ways to connect PostgreSQL. You can choose one of the following ways.
Connect to PostgreSQL docker.
Connect to local PostgreSQL.
Connect to remote PostgreSQL.
In order to connect to a remote database, you must obtain information about the database and the server. Note the following database details so you can use them to configure your Equito node later.
Server hostname or IP
Port
Username
Password
Database name
The user must be the owner of the database.
This DATABASE_URL should be set in .env file of Equito Node.
[POSTGRES_USER]: The username for the database owner account.
[POSTGRES_PASSWORD]: The password for the database owner account.
[DB_HOST]: The server hostname or IP address of the database server.
[DB_PORT]: The port that the database is listening on. The default port for PostgreSQL is 5432.
[POSTGRES_DB]: The name of the database to use for the Equito node.
[SSL_MODE]: If you are testing on a database that does not have SSL enabled, you can specify disable so that you don't need to go through the process of configuring SSL on your database. On a production node, set this value to require.
When you want to connect PostgreSQL docker
Run PostgreSQL in a Docker container. You can replace mysecretpassword with your own password.
Create a local directory to hold the Equito Protocol data
mkdir~/.equito-node
Run the following command to create .env file and set environment variables. It includes setttings of wallet and API keys. The wallets should be include more than 0.3 Sepolia ETH and 0.3 BNB.
You can confirm that the variables are set correctly in .env file.
cat~/.equito-node/.env
Start the Equito Node by running the Docker image.
cd ~/.equito-node && docker run --env-file ~/.equito-node/.env -d --platform linux/x86_64/v8 --name equito-node -it -p 7890:7890 --add-host=host.docker.internal:host-gateway robindev912/equito-validator-node
Confirm that the container is running. Note the 7890 port is published 0.0.0.0:7890->7890/tcp and therefore accessible outside of Docker.
dockerps-a-fname=equito-node
If the container is running successfully, the output shows a healthy status:
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
63318f25608e robindev912/equito-validator-node "/sbin/tini -- npm s…" 7 minutes ago Up 7 minutes 0.0.0.0:7890->7890/tcp, :::7890->7890/tcp equito-node
The following services offer Ethereum and Binance API endpoints to work with the Validator node. It is necessary to get API endpoints and set them in .env file.
These are the only environment variables that are required for a Validator node to run. Configure the necessary environment variables in the .env file by obtaining API endpoints from relevant external services. We recommend you to use premium API endpoints for optimal performance and high quality.
Other Configuration
Connect your domain to your hosting. It needs to use SSL for the Domain URL.
Ensure that port 7890 is open for communication with the Equito Node APIs. Redirect your Node URL to this 7890 port using Nginx.
Check all env variables are set correctly.
~/.equito-node docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
c4a9a8a83a6d equito-validator-node "docker-entrypoint.s…" 13 seconds ago Up 13 seconds 0.0.0.0:7890->7890/tcp gifted_lovelace
d039fc4c24d7 postgres "docker-entrypoint.s…" 22 seconds ago Up 21 seconds 0.0.0.0:5432->5432/tcp eqt-postgres
Check status of docker. When you see logs of Equito Node docker, if it is successful, it will show the following logs.
dockerlogsc4a9a8a83a6d
Application has started on 7890
--- dev --- Version: v1.0.240408
--- dev --- Binance block number: 39291754
--- dev --- Binance balance: 9.114297628639779115
--- dev --- Ethereum block number: 5654911
--- dev --- Ethereum balance: 7.893833242556830353
--- dev --- Arbitrum block number: 31621583
--- dev --- Arbitrum balance: 1.00058447087105
--- dev --- Avalanche block number: 31658947
--- dev --- Avalanche balance: 0.5784483945
--- dev --- Base block number: 8409805
--- dev --- Base balance: 0.799630560919761313
--- dev --- Celo block number: 23439320
--- dev --- Celo balance: 20.213343596
--- dev --- Fantom block number: 25196457
--- dev --- Fantom balance: 14.040263020005596
--- dev --- Optimism block number: 10392683
--- dev --- Optimism balance: 0.699675065874292012
--- dev --- Polygon block number: 48010332
--- dev --- Polygon balance: 0.431530183523206655
--- dev --- Success to set all keys.
If all containers are running and you get logs of success, the node is working.
FAQ
How to update the Equito Node docker to up-to-date version?
See the running docker list.
dockerps-a
You can get all of dokcer containers list.
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
dc1dfc0b5847 robindev912/equito-validator-node "docker-entrypoint.s…" 3 minutes ago Up 3 minutes 0.0.0.0:7890->7890/tcp, :::7890->7890/tcp equito-node
Stop and remove the Equito Node docker.
dockerstopdc1dfc0b5847dockerrmdc1dfc0b5847
Get the latest version of Equito Node docker.
dockerpullrobindev912/equito-validator-node
Run the Equito Node docker.
cd ~/.equito-node && docker run --env-file ~/.equito-node/.env -d --platform linux/x86_64/v8 --name equito-node -it -p 7890:7890 --add-host=host.docker.internal:host-gateway robindev912/equito-validator-node
How to check the runnig Equito Node docker is the up-to-date version?
Get the container ID of running Equito Node docker.
dockerps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
3215274b7c34 robindev912/equito-validator-node "docker-entrypoint.s…" 12 minutes ago Up About a minute 0.0.0.0:7890->7890/tcp, :::7890->7890/tcp equito-node
Get the logs of running docker.
dockerlogs3215274b7c34
If you see the following log, your Equito Node docker should be pulled to a new version.
If you can't see the following log, your Equito Node docker image is up-to-date.
Application has started on 7890
--- dev --- Error : New version is published
How to verify Node URL is properly linked to Equito Node docker?
When you check the Node URL in web browser, if you set all configuration properly, you can see the following result.