🟢Lamina1

---

1. System Requirements

Ensure your machine meets the following minimum requirements:

• Operating System: Linux (Ubuntu 20.04+ recommended)

• CPU: 4 or more cores

• RAM: 16 GB or higher

• Disk: SSD with at least 200 GB of free space

• Network: 1 Gbps connection preferred

• Software Dependencies: Docker and Docker Compose

2. Prerequisites

1. Install Docker: If Docker is not already installed on your system, install it using the following commands:

   sudo apt update
   sudo apt install -y docker.io

2. Install Docker Compose: Docker Compose is needed to manage the node’s services. Install it using:

   sudo apt install -y docker-compose

3. Verify Installation: Check if Docker and Docker Compose are properly installed:

   docker --version
   docker-compose --version

   This should display the versions of Docker and Docker Compose.

3. Setting Up the Node

1. Clone the Lamina1 Node Repository: Start by cloning the official Lamina1 Betanet repository:

   git clone https://github.com/Lamina1/lamina1-betanet.git
   cd lamina1-betanet

2. Create the Configuration File: You need to create a .env file to configure your node. Create this file in the root of the lamina1-betanet directory:

   touch .env

   Open the file using a text editor (e.g., nano) and add the following content:

   NODE_NAME=<YOUR_NODE_NAME>
   NODE_PUBLIC_IP=<YOUR_PUBLIC_IP>

   • Replace <YOUR_NODE_NAME> with a unique name for your node.

   • Replace <YOUR_PUBLIC_IP> with your machine’s public IP address.

3. Generate Keys: You’ll need to generate the keys for your node. Use the following script:

   ./scripts/generate-keys.sh

   This script will create a set of keys and configuration files for your node.

4. Running the Node

1. Start the Node: Use Docker Compose to start the node:

   docker-compose up -d

   This command will start the Lamina1 node in detached mode (-d), meaning it will run in the background.

2. Check Node Logs: To check if the node is running correctly, view the logs using:

   docker-compose logs -f

   Look for messages indicating that the node is syncing with the Betanet.

3. Stop the Node: If you need to stop the node for any reason, use:

   docker-compose down

5. Monitoring and Maintenance

1. Node Health Check: To verify the health and sync status of your node, run:

   curl -s http://localhost:3030/status | jq

   This will display detailed information about your node’s status.

2. Troubleshooting: If you encounter issues, check the Docker logs for errors:

   bashSkopiuj koddocker-compose logs | grep -i "error"

3. Updating the Node: As Lamina1 releases updates, you may need to pull the latest changes:

   git pull
   docker-compose build
   docker-compose up -d

   This will ensure your node is running the latest version.

6. Security Considerations

1. Firewall Configuration: Ensure your firewall allows the following ports:

   • 3030: For node communication

   • 24567: For peer-to-peer networking

   Use ufw to configure the firewall:

   sudo ufw allow 3030
   sudo ufw allow 24567

2. Node Backup: Regularly back up your keys and configuration files. Store them in a secure location to prevent data loss.

7. Common Issues and Solutions

1. Docker Permissions Issue: If you receive a permission error when running Docker commands, add your user to the Docker group:

   sudo usermod -aG docker $USER

   Log out and log back in for the changes to take effect.

2. Node Not Syncing:

   • Check if your firewall settings are correct.

   • Ensure that the .env file has the correct IP and port configurations.

3. Outdated Node Version: If your node fails to sync or throws errors, it could be due to an outdated version. Update the node as described in the Updating the Node section.