HOW TO RUN KNOTCOIN v1.0.1
Step-by-step guide for macOS, Windows, and Linux
What You'll Need• 10 minutes of your time
• 2 GB free disk space
• Internet connection
• Basic command line knowledge (we'll guide you)
macOS Setup (Apple Silicon & Intel)Step 1: DownloadApple Silicon (M1/M2/M3):
curl -L -O https://github.com/Ponknot/Knotcoin/releases/download/v1.0.1/knotcoin-v1.0.1-macos-apple-silicon.tar.gz
Intel Mac:
curl -L -O https://github.com/Ponknot/Knotcoin/releases/download/v1.0.1/knotcoin-v1.0.1-macos-intel.tar.gz
Step 2: Verify ChecksumApple Silicon:
shasum -a 256 knotcoin-v1.0.1-macos-apple-silicon.tar.gz
Expected:
80237ae494882d9121ed9cad3e1ee04fb19bdb92538b35ffeeb0c3554ab0da4aIntel:
shasum -a 256 knotcoin-v1.0.1-macos-intel.tar.gz
Expected:
bc59b551d457403048056018e05b0a83f1b25db56dcd2f93367362e3a3a585c8Step 3: Extracttar -xzf knotcoin-v1.0.1-macos-*.tar.gz
cd macos-apple-silicon # or macos-intel
Step 4: Make Executablechmod +x knotcoind knotcoin-cli
Step 5: Run the NodeYou'll see the Knotcoin banner and the node will start syncing. Keep this terminal open.
Step 6: Create a Wallet (New Terminal)Open a new terminal window:
cd macos-apple-silicon # or macos-intel
./knotcoin-cli generatewallet
Write down your 24-word mnemonic. This is your wallet backup. Never share it.
Step 7: Start Mining./knotcoin-cli generatetoaddress 1 YOUR_KOT1_ADDRESS
Replace YOUR_KOT1_ADDRESS with the address from step 6.
Optional: Run in BackgroundStop the node (Ctrl+C), then:
nohup ./knotcoind > ~/knotcoin.log 2>&1 &
Now you can close the terminal and the node keeps running.
Windows SetupStep 1: DownloadDownload from:
https://github.com/Ponknot/Knotcoin/releases/download/v1.0.1/knotcoin-v1.0.1-windows-x86_64.tar.gzStep 2: ExtractRight-click the file → Extract All → Choose a location
Step 3: Verify ChecksumOpen PowerShell in the extracted folder:
Get-FileHash knotcoind.exe -Algorithm SHA256
Step 4: Run the NodeDouble-click
knotcoind.exe or run in Command Prompt:
The node will start. Keep this window open.
Step 5: Create WalletOpen a new Command Prompt in the same folder:
knotcoin-cli.exe generatewallet
Save your 24-word mnemonic securely.
Step 6: Start Miningknotcoin-cli.exe generatetoaddress 1 YOUR_KOT1_ADDRESS
Optional: Run as ServiceTo run in background, use Task Scheduler or NSSM (Non-Sucking Service Manager).
Linux SetupStep 1: Downloadwget https://github.com/Ponknot/Knotcoin/releases/download/v1.0.1/knotcoin-v1.0.1-linux-x86_64.tar.gz
Step 2: Verify Checksumsha256sum knotcoin-v1.0.1-linux-x86_64.tar.gz
Expected:
eb70aec56189244030ee8451b1ac18c629ae82503705d80ec03a95b42bb75360Step 3: Extracttar -xzf knotcoin-v1.0.1-linux-x86_64.tar.gz
cd linux-x86_64
Step 4: Make Executablechmod +x knotcoind knotcoin-cli
Step 5: Run the NodeStep 6: Create Wallet (New Terminal)cd linux-x86_64
./knotcoin-cli generatewallet
Save your mnemonic.
Step 7: Start Mining./knotcoin-cli generatetoaddress 1 YOUR_KOT1_ADDRESS
Optional: Run as Systemd Servicesudo nano /etc/systemd/system/knotcoin.service
Paste:
[Unit]
Description=Knotcoin Node
After=network.target
[Service]
Type=simple
User=YOUR_USERNAME
ExecStart=/path/to/knotcoind
Restart=always
[Install]
WantedBy=multi-user.target
Enable and start:
sudo systemctl enable knotcoin
sudo systemctl start knotcoin
Anonymous Mining with Tor (All Platforms)Want to hide your IP? Use Tor.
macOS:brew install tor
brew services start tor
Linux:sudo apt install tor
sudo systemctl start tor
Windows:Download Tor Browser from torproject.org or install Tor as a service.
Once Tor is running, Knotcoin automatically uses it for .onion connections. Your IP stays hidden.
Web Explorer (Optional)Knotcoin includes a built-in web interface for wallet management and mining.
cd explorer
python3 -m http.server 8080
Open browser:
http://localhost:8080You can:
• Generate wallets
• Check balances
• Mine blocks
• View blockchain
Common Commands# Check block count
./knotcoin-cli getblockcount
# Check balance
./knotcoin-cli getbalance YOUR_ADDRESS
# Generate wallet
./knotcoin-cli generatewallet
# Mine 10 blocks
./knotcoin-cli generatetoaddress 10 YOUR_ADDRESS
# Stop node
./knotcoin-cli stop
Troubleshooting"Database locked" error:Another instance is running. Stop it first:
pkill knotcoind # macOS/Linux
taskkill /F /IM knotcoind.exe # Windows
"Unauthorized" error:The CLI can't find the auth token. Use curl instead:
curl -H "Authorization: Bearer $(cat ~/.knotcoin/mainnet/.cookie)" \
-H "Content-Type: application/json" \
-d '{"method":"getblockcount"}' \
http://127.0.0.1:9001
Port 9000 blocked:Open port 9000 in your firewall for incoming P2P connections.
Can't connect to peers:The network is new. Be patient. The Tor seed node will help you find peers.
Network Info•
P2P Port: 9000 (must be open for incoming)
•
RPC Port: 9001 (localhost only)
•
Tor Seed: u4seopjtremf6f22kib73yk6k2iiizwp7x46fddoxm6hqdcgcaq3piyd.onion:9000
•
Data Directory: ~/.knotcoin/mainnet
Run a Seed NodeHelp the network grow! If you have:
• Static IP or domain
• Port 9000 open
• 24/7 uptime
Post your node info here and we'll add it to the next release:
IP: your.ip.address:9000
Location: [Country/Region]
Uptime: 24/7
Early seed operators get recognition in the community.
Security Tips✓ Always verify checksums before running
✓ Never share your 24-word mnemonic
✓ Use Tor for anonymous mining
✓ Keep your wallet backup offline
✓ Only download from official GitHub releases
Links•
GitHub: https://github.com/Ponknot/Knotcoin•
Releases: https://github.com/Ponknot/Knotcoin/releases•
Documentation: See README.md in release archives
Welcome to Knotcoin!
Fair launch. No pre-mine. Quantum-resistant. Memory-hard mining.
"I Need help getting the network bootstrapped. Looking for 2-3 volunteers to run seed nodes.
Requirements:
- Static IP or domain
- Port 9000 open
- 24/7 uptime preferred
I'll add your IPs to v1.01 release. First volunteers get recognition as founding seed node operators.
Reply with 'YourIP:9000' if you can help." ---- just wanna see who volunteers this fair launch initiative

How start mining on Windows?
PS D:\Mining\Knotcoin\windows-x86_64> ./knotcoin-cli.exe generatetoaddress 10 KOT1MBVBKBHLPAS57HMRVIT2IVRJBFQH6RIUJQ66ZJ37USP4VMWOLHLQLHMTU5Y
Unauthorized
@Sergick2023 - Good catch on trying to mine! However, there's a bootstrap issue right now.
The network is live, but v1.0.0 doesn't have hardcoded seed nodes yet. This means:
- Your node can't connect to other nodes
- You can't sync the blockchain
- Mining won't work until you're synced
I am working on v1.01 with seed nodes included. In the meantime:
Option 1: Wait for v1.01 (coming soon with seed nodes)
Option 2: If you have a static IP and can run 24/7, volunteer as a seed node (see my post above)
Sorry for the inconvenience - this is the chicken-and-egg problem of launching a new network. Once we have 2-3 seed nodes, everyone will be able to connect and mine.I just want this project to be owned by the people.
I'll post an update when v1.01 is ready!
UPDATE: v1.0.1 Explorer Fix AppliedThe web explorer in the initial v1.0.1 release wasn't connecting properly. This has been fixed and the release has been updated.
If you downloaded v1.0.1 before Feb 26, 2026 8:00 PM UTC, please re-download:https://github.com/Ponknot/Knotcoin/releases/tag/v1.0.1What changed:• Fixed web explorer showing "OFFLINE"
• Explorer now uses Node.js server (see setup guide for instructions)
• Node binary unchanged - if your node is running, no need to restart
Important: The command-line tools (knotcoind, knotcoin-cli) were never affected and work perfectly. This fix only applies to the web UI.
To use the explorer:cd explorer/
node server.js
# Open http://localhost:8080/
New checksums are included in the release. The network is live and running smoothly!