kasnodes
Crawling the networkCrawl24.8%

Kaspa NG on Linux

Easiest10 stepsAbout 10 minutes, plus the sync
1. Download Kaspa NG0 of 10 done
  1. Download Kaspa NG
  2. Install it
  3. Open it the first time
  4. Set up the node
  5. Let it sync
  6. Create a wallet
  7. Check it is working
  8. Make it public
  9. Start it when you sign in
  10. Troubleshooting

Before you start

1

Download Kaspa NG

Get the newest release from the official GitHub page.

  1. Open the Kaspa NG releases page.
  2. Take the newest release, at the top.
  3. Under Assets, download kaspa-ng_X.X.X_amd64.deb.

It is the only Linux build: for Debian, Ubuntu, Linux Mint and Pop!_OS on a 64-bit Intel or AMD processor. On another distribution or an ARM board, use native kaspad or Docker instead.

2

Install it

apt installs the package and anything it needs.

cd ~/Downloads
sudo apt install ./kaspa-ng_*_amd64.deb
It is installed when
  • which kaspa-ng prints /usr/bin/kaspa-ng
3

Open it the first time

From your app menu, or from a terminal.

App menu
Look for Kaspa NG in your launcher
Terminal
kaspa-ng
It worked when
  • Kaspa NG opens on its welcome screen
4

Set up the node

The welcome screen asks for a few settings the first time.

  1. Under Kaspa Network, choose Mainnet, the live network. Testnet is for developers.
  2. Under Kaspa p2p Node & Connection, keep Integrated Daemon. Remote uses someone else's node, and Disabled runs none.
  3. Pick a language and theme, then choose Apply. The node starts.

The node keeps the chain in ~/.rusty-kaspa. To keep it on a larger drive, open Settings, then Data Storage, and set a custom data storage folder.

5

Let it sync

The node downloads the chain from other nodes and checks every block itself. It only has to do this once.

The main window shows progress, block height against the network's, and peers. On a machine that meets the requirements it usually takes one to two hours, longer on a slower disk or connection. You can keep using the computer; just leave Kaspa NG open.

It has synced when
  • Progress reaches 100%, or it says Synced
  • Your block height matches the network's
  • New blocks arrive many times a second
6

Create a wallet

Kaspa NG includes a wallet for sending, receiving and keeping KAS. Optional for running a node.

Write the seed phrase on paper. Never photograph it, store it on a computer or share it. It is the only way to get the wallet back. The password only protects the wallet on this computer; lose the seed phrase and the funds are gone.

  1. Open Wallet, then create a new wallet.
  2. Write down the 12 or 24 words, in order. Kaspa NG asks for some of them back.
  3. Choose a strong password.
  4. Your address appears, starting kaspa:.
7

Check it is working

A running node shows all of these.

It is working when
  • It says Synced, or 100%
  • 8 or more peers are connected
  • The block height keeps rising
  • The log shows no repeating errors
8

Make it public

Optional, and the most useful thing you can do. Your node reaches out to others already; a public one also lets them reach it, which helps new nodes join and sync.

Kaspa NG asks your router to open port 16111 by itself (UPnP), so it may be public already. Check with Check my node after an hour. If it isn't, forward the port by hand:

  1. Find this computer's local address (ip addr, or your network settings), for example 192.168.1.42.
  2. Open your router's admin page, usually at 192.168.1.1 or 192.168.0.1.
  3. Add a port forwarding rule: TCP, external port 16111, to that address, port 16111. Save it.

Open the port in the firewall too, if one is on. UFW (Ubuntu, Debian):

sudo ufw allow 16111/tcp
sudo ufw status

Router menus differ. portforward.com has steps for most models.

It is public when
  • Kaspa NG shows inbound peers, often 20 to 50 or more
  • It appears on KasNodes after the next crawl
9

Start it when you sign in

Optional. Kaspa NG is a desktop app, so it runs while you are signed in. Add it to your desktop's startup apps.

GNOME, Ubuntu
Startup Applications, Add, with the command kaspa-ng
KDE Plasma
System Settings, Autostart, Add Application, Kaspa NG

For a machine that runs with nobody signed in, use native kaspad as a service instead.

10

Troubleshooting

The usual problems and what fixes them.

The install reports missing packages

Install with sudo apt install ./kaspa-ng_*_amd64.deb rather than dpkg, so apt fetches what it needs. If dpkg left it half installed, run sudo apt-get install -f.

It won't open, or closes at once

Run kaspa-ng in a terminal to see the error. It needs a desktop session; on a server with no screen, use native kaspad.

The sync is stuck

It has usually lost its peers. Check the connection, quit and reopen Kaspa NG, turn off any VPN while syncing, and check the firewall isn't blocking it. Still stuck after ten minutes? Ask in the Kaspa Discord.

It shows 0 peers

It can't reach the network. Check the connection and the firewall; work networks often block peer-to-peer traffic. Restart Kaspa NG first.

The computer is slow while it runs

Syncing works the computer hard, and it passes. With less than 16 GB of memory, close other apps while it syncs, and expect trouble later: the node needs 16 GB. You can quit and reopen it; the sync carries on where it stopped.

The disk is filling up

Free some space, or move the chain to a larger drive with a custom data storage folder in Kaspa NG's settings. Keep 640 GB free for it; 1 TB is better.

I forgot my wallet password

With the seed phrase you can restore it: remove the wallet in Kaspa NG, add it again from the seed phrase and set a new password. Without the seed phrase the funds can't be recovered.

It isn't public after forwarding the port

Check this computer's local address hasn't changed, the rule is TCP not UDP, and try your router's Virtual Servers section if it has one. Restart the router. Some internet providers block inbound connections at home.

Running? Put your name on it.

Once the node shows up in a crawl you can claim it, pick a public name and follow its rank.

All setup methodsClaim my node