Automated setup with the installer
This page will guide you through the DKG Edge Node installation process for MacOS and Linux
Last updated
Was this helpful?
This page will guide you through the DKG Edge Node installation process for MacOS and Linux
Last updated
Was this helpful?
macOS
Ubuntu 22.04 and Ubuntu 24.04
Edge node installer will detect your operating system automatically (MacOS or Linux) so no configuration related to this is required by the user.
Before getting started with the installation, there are a few important preparations to make. The process requires certain inputs such as wallet addresses and funds. The following sections will walk you through each of these prerequisites step by step.
(macOS)
The Edge Node uses three types of keys: a management key, an operational key, and a publishing key. The management and operational keys need a small amount of the utility token based on the blockchain you will be using (NEURO, Base ETH, xDai) to sign transactions for certain operations, while publishing key requires both the utility and TRAC tokens to perform publishing operations. To check your wallets funds on Neuroweb testnet, use .
Once you have your wallets funded and ready, you may proceed with cloning, configuring and running the Edge node installer by following the instructions provided below.
The .env.example is used as a guide template, but is well documented and should help you understand what each of the variables mean.
To simplify the development setup, we’ve provided the env-setup.js script.
This script will automatically generate and populate all required .env parameters, including:
Management keys
Operational keys
Publishing keys (for all supported chains)
Node name (same across all chains)
To populate your .env file, run:
We assume that Node.js is already installed on your system to run the env-setup.js script.
If Node.js is not installed or you're setting up on a fresh system, we recommend using NVM to install Node.js version 20 along with npm.
Once Node.js and npm are successfully installed, you can use the following command to populate your .env file:
Once the .env file is populated with the mandatory parameters, you will have to fund the keys (wallets) which were added to the .env file.
Open your .env file using nano or any text editor.
Locate the following wallet entries for each blockchain:
OPERATIONAL_KEY_PUBLIC_ADDRESS
MANAGEMENT_KEY_PUBLIC_ADDRESS
PUBLISH_WALLET_01_PUBLIC_KEY
Neuroweb: TRAC and NEURO
Gnosis Chiado: TRAC and xDai
It’s important to ensure that your node creates its profile on the blockchain specified in DEFAULT_PUBLISH_BLOCKCHAIN parameter.
For Neuroweb, first use the faucet to acquire NEURO in order to initiate your wallet, and then request TRAC, otherwise the TRAC funding transaction will fail.
Edge Node components require a large language model (LLM) to operate. To ensure full functionality, you must provide at least one of the supported external API keys below:
🔐 Ensure that the API keys have the necessary usage quotas and permissions based on your expected workload. Always keep them secure and never share them publicly.
The Edge Node supports additional external services and tools that can be configured via the .env file before running the installer. Below is a list of supported services represented as configuration parameters:
Once all the required parameters have been configured in the .env file, simply run the installer and wait for it to finish the Edge node setup.
Edge node installer will deploy each component within the edge_node directory: drag-api, edge-node-auth-service, ka-mining-api, ot-node.
Edge node services will be available and listening on the following local ports upon installation:
3001 - Authentication service
3002 - API (backend)
5002 - dRAG
5005 - Knowledge mining
8900 - OT Node
UI (Edge node interface) will be cloned and configured in the following paths:
MacOS - /opt/homebrew/etc/nginx/servers/edge-node-ui
Linux - /var/www/edge-node-ui
The default login credentials for the Edge node UI are as follows:
username: my_edge_node
password: edge_node_pass
Follow our official channels for updates:
Fund wallets for at least one blockchain in the .env file using our faucet. Instructions on how to use the Faucet can be found on the . Our faucet can provide you with the testnet tokens as follows:
Base Sepolia: TRAC (ETH for Base Sepolia can be received via the faucets provided in the official Base )
API Key – Used to access OpenAI’s GPT models.
Example: sk-4hsR2exampleXv29NSHtDyzt0NlFgk1LXj6zS7
API Key – Used to access Anthropic’s Claude models.
Example: claude-56a8e5eexamplef27b5b6e47b1
UI will be available on
Once the Edge Node is up and running in your local environment, you’re ready to explore its features and capabilities. To get started, refer to the section to learn how to interact with the node and understand what it can do.
If you encounter any issues during the installation process or have questions about any of the topics above, jump into our official and ask for assistance.