> For the complete documentation index, see [llms.txt](https://services.validexis.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://services.validexis.com/mainnets/polkadot/installing-a-polkadot-node-using-kagome.md).

# 🔧 Installing a Polkadot Node Using Kagome

### *System Preparation*

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

*Check your OS version:*

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

## ***Automatic Installation***

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

## ***Manual Installation***

### *Add Kagome Repository*

*Import the GPG key:*

```bash
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:*

```bash
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:*

```bash
sudo apt update
```

### *Install Kagome*

```bash
sudo apt install -y kagome
kagome --version
```

### *Create User and Database Directory*

*Create a dedicated system user:*

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

*Create the base path directory:*

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

### *Create systemd Service*

*Create the service file:*

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

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

```bash
[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*

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

*Check service status:*

```bash
sudo systemctl status kagome
```

*Check service logs*:

```bash
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.