# Artela Node

By [Imensidaof](https://paragraph.com/@imensidaof) · 2024-11-26

---

**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](https://www.docker.com/products/docker-desktop/).

#### 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
        
    

* * *

---

*Originally published on [Imensidaof](https://paragraph.com/@imensidaof/artela-node)*