Cover photo

Artela Node

1. Prerequisites

Before starting, ensure you have the following:

  • Operating System: Linux or macOS (Windows users can use WSL2 or a Linux VM).

  • Hardware Requirements:

    • CPU: 4-core processor or better.

    • RAM: At least 8 GB.

    • Storage: Minimum 100 GB free disk space.

    • Network: Stable internet connection with good bandwidth.

  • Software Dependencies:

    • Docker and Docker Compose installed.

2. Installation Steps

Step 1: Install Docker

If you don’t have Docker installed, follow these steps:

On Ubuntu:

sudo apt update
sudo apt install -y docker.io
sudo systemctl start docker
sudo systemctl enable docker

On macOS:

Download and install Docker Desktop from the official Docker website.

Verify Docker Installation:

docker --version

Step 2: Install Docker Compose

On Linux:

sudo apt install -y docker-compose

On macOS:

Docker Compose is bundled with Docker Desktop.

Verify Docker Compose Installation:

docker-compose --version

Step 3: Clone the Artela Full Node Repository

Download the repository containing the required configuration files:

git clone https://github.com/artela-network/full-node.git
cd full-node

Step 4: Configure Node Settings

Locate the configuration file (e.g., config.yaml or .env) in the cloned repository. Modify it as per your requirements:

  1. Open the file for editing:

    nano config.yaml

  2. Update fields like:

    • Node name

    • Wallet address

    • Network settings (e.g., mainnet or testnet)

Save and exit (Ctrl + O, Enter, Ctrl + X).

Step 5: Start the Node

Run the following command to start your full node:

docker-compose up -d

This command will:

  • Download the necessary images.

  • Start the node in detached mode.

Step 6: Check Node Logs

Verify that your node is running correctly by checking the logs:

docker-compose logs -f

Look for messages indicating a successful connection to peers.

Step 7: Monitor Node Status

Use the following command to check the node's status and connected peers:

curl http://localhost:8545/status

(Replace 8545 with the appropriate port number based on your configuration.)

3. Troubleshooting

  • Node Fails to Start: Check the logs for error messages and verify that your configuration file is correct.

  • Connectivity Issues: Ensure that your firewall allows incoming and outgoing traffic on the required ports.

  • Disk Usage: Monitor disk space periodically to ensure you have enough storage for blockchain data:

    df -h

4. Updating the Node

To update your node to the latest version:

  1. Pull the latest repository changes:

  2. Rebuild and restart the containers:

    docker-compose down
docker-compose up -d