Skip to main content

Run a node

System Requirements

Operating SystemLinux or MacOS
Number of CPU cores2

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.


30303TCPgeth syncingport must be open
30303UDPgeth discoveryport must be open
13000TCPbeacon syncingport must be open
12000UDPbeacon discoveryport 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

  1. curl
  2. Docker
  3. Docker Compose

Install curl

sudo apt-get -y update
sudo apt-get -y install curl

Install Docker

curl -fsSL -o
sudo sh

Install Docker Compose

sudo curl -L "$(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

  1. Homebrew package manager
  2. curl
  3. Docker Desktop for Mac

Install Homebrew

/bin/bash -c "$(curl -fsSL"

Install Curl

brew install curl

Install Docker Desktop for Mac

Go to 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 | 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
Want to run a validator node?

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.