kasnodes
Crawling the networkCrawl25.7%

Kaspa NG on macOS

Easiest9 stepsAbout 10 minutes, plus the sync
1. Download Kaspa NG0 of 9 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. 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-vX.X.X-macos-arm64.zip.
2

Install it

The download is a single program, not an app you drag to Applications. Give it a folder of its own.

Double-click the .zip in Downloads to unzip it, then in Terminal move the program to your home folder and clear the block macOS puts on downloaded programs:

mkdir -p ~/kaspa-ng
mv ~/Downloads/kaspa-ng-*-macos-arm64/kaspa-ng ~/kaspa-ng/
xattr -c ~/kaspa-ng/kaspa-ng
It is installed when
  • ls ~/kaspa-ng lists kaspa-ng
3

Open it the first time

Double-click kaspa-ng in the kaspa-ng folder, or run it from Terminal. A Terminal window opens beside the app; leave it open while Kaspa NG runs.

~/kaspa-ng/kaspa-ng

If macOS still says it can't be opened, choose Done, open System Settings, Privacy & Security, choose Open Anyway next to kaspa-ng, and enter your password.

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 (System Settings, Network, your connection, Details), 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.

Keep the macOS firewall on; it can still let Kaspa NG accept connections. Only forward port 16111. On a work or school network, ask IT first.

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

Troubleshooting

The usual problems and what fixes them.

macOS says kaspa-ng can't be opened

Clear the block again with xattr -c ~/kaspa-ng/kaspa-ng, or open it once, choose Done, then Open Anyway in Privacy & Security. Open Anyway only appears after you have tried to open it.

It says bad CPU type

Kaspa NG is only built for Apple silicon (M1 or newer). On an Intel Mac, use Docker instead.

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