Run a node
System Requirements
| Settings | Value |
|---|---|
| Operating System | Linux or MacOS |
| Number of CPU cores | 2 |
| RAM | 16 GB |
| SSD | 100 GB |
Apple's new M1 chips are not supported natively by our node client. However, you can follow this guide to run it by using Rosetta, Apple's built-in emulation software.
Ports
| Port | Protocol | Client | Description |
|---|---|---|---|
| 30303 | TCP | geth syncing | port must be open |
| 30303 | UDP | geth discovery | port must be open |
| 13000 | TCP | beacon syncing | port must be open |
| 12000 | UDP | beacon discovery | port must be open |
Linux System Setup
For instructions on setting up a Mac, proceed to the MacOS System Setup section.
Configure Firewall
Deny all incoming traffic by default
sudo ufw default deny incoming
sudo ufw default allow outgoing
Allow traffic for the ports listed above.
sudo ufw allow 30303/tcp
sudo ufw allow 30303/udp
sudo ufw allow 13000/tcp
sudo ufw allow 12000/udp
You can forward extra ports, by using the following command:
sudo ufw allow [replace_with_your_ssh_port]/tcp/udp
This can be useful for setting up you ssh connection or monitoring.
Enable firewall
sudo ufw enable
NOTE: Make sure also to configure your router to forward these ports.
You may follow this community-authored Port Forwarding guide.
Install Dependencies
Install curl
sudo apt-get -y update
sudo apt-get -y install curl
Install Docker
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
Install Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
docker-compose --version
MacOS System Setup
Configure Firewall
This section is in the works
This section is in the works
Install Dependencies
Install Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Install Curl
brew install curl
Install Docker Desktop for Mac
Go to https://docs.docker.com/desktop/mac/install/ and install the application. You do not have to install Docker Compose separately.
Open the Docker Desktop application after installing from the applications folder on your Mac
Install the LUKSO Command Line Interface (CLI)
Create a directory:
mkdir lukso-l16-testnet
and navigate to it in your terminal by using the cd command
cd lukso-l16-testnet
Then, install the LUKSO CLI using the install script:
sudo curl https://install.l16.lukso.network | sudo bash
Check your LUKSO CLI version
lukso -v
The output has to be v.0.4.3 or higher.
Initialize the network
sudo lukso network init --chain l16
The CLI will ask you to setup your node name.
Start your node
You can start your node with:
sudo lukso network start
Check your node
Wait 1 hour and check if your node has synced on this stats page:
Immediately after starting your node you can check the syncing process in your logs.
Stop your node
sudo lukso network stop
If you want, you are now ready to run validators on your node. Check the tutorial on the validator page.
Need help?
Ask your question in the validators channel on the official LUKSO Discord server.