🔧 Installing a Polkadot Node Using Kagome

System Preparation

sudo apt update && sudo apt upgrade -y
sudo apt install -y gpg curl lz4

Check your OS version:

lsb_release -a
# Should return something like: Ubuntu 24.04.1 LTS

Automatic Installation

source <(curl -s https://raw.githubusercontent.com/validexisinfra/polkadot/main/install_kagome.sh)

Manual Installation

Add Kagome Repository

Import the GPG key:

curl -fsSL https://europe-north1-apt.pkg.dev/doc/repo-signing-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/europe-north-1-apt-archive-keyring.gpg

Add the repository source:

echo "deb [signed-by=/usr/share/keyrings/europe-north-1-apt-archive-keyring.gpg] https://europe-north1-apt.pkg.dev/projects/kagome-408211 kagome main" | sudo tee /etc/apt/sources.list.d/kagome.list

Update your package index:

sudo apt update

Install Kagome

sudo apt install -y kagome
kagome --version

Create User and Database Directory

Create a dedicated system user:

sudo useradd -m -r -s /bin/false kagome

Create the base path directory:

sudo mkdir -p /home/kagome/polkadot-node-1
sudo chown -R kagome:kagome /home/kagome

Create systemd Service

Create the service file:

sudo nano /etc/systemd/system/kagome.service

Paste the following content (replace <your-node-name> and <your-public-ip>):

[Unit]
Description=Kagome Node

[Service]
User=kagome
Group=kagome
LimitCORE=infinity
LimitNOFILE=65536
ExecStart=/usr/local/bin/kagome \
  --name <your-node-name> \
  --base-path /home/kagome/polkadot-node-1 \
  --public-addr=/ip4/<your-public-ip>/tcp/30334 \
  --listen-addr=/ip4/0.0.0.0/tcp/30334 \
  --chain polkadot \
  --rpc-port=9944 \
  --prometheus-port=9615 \
  --telemetry-url 'wss://telemetry.polkadot.io/submit/ 1' \
  --telemetry-url 'wss://telemetry-backend.w3f.community/submit/ 1' \
  --node-key 63808171009b35fc218f207442e355b0634561c84e0aec2093e3515113475624 \
  --database rocksdb \
  --sync Warp \
  --enable-db-migration

Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Enable and Start the Node

sudo systemctl daemon-reload
sudo systemctl enable kagome
sudo systemctl start kagome

Check service status:

sudo systemctl status kagome

Check service logs:

journalctl -u kagome -f

Check Your Node on Polkadot Telemetry

Once your node is running, you can verify that it's connected and visible on the Polkadot telemetry dashboard:

🔗 https://telemetry.polkadot.io/

Look for your node by the name you specified in the --name argument of your kagome.service file.