Spin up a TexitCoin full node.

Configure the parameters, copy the one-liner — or grab a self-contained install.sh with systemd and UFW wired up. Designed for a fresh Ubuntu 22.04 or 24.04 LTS box (amd64) — bare-metal or VPS.

OS Support

Ubuntu 22.04 / 24.04

Fresh LTS install · amd64

TexitCoin Core

v0.25.2

Latest GitHub release · checked daily

Chain footprint

~5 GB

Full sync, no pruning

Min droplet

2 vCPU / 4 GB

+ 4 GB swap recommended

1. Node Configuration

Node Moniker

Network

P2P Port

RPC Port

RPC User

RPC Password

Specific release tag (optional)

Pulls the GitHub Release for this exact tag (devs build & ship from tags before merging to master). Must have a ubuntu22/ubuntu24 .zip asset attached. Overrides the toggle above.

Custom zip URL (optional, overrides everything)

Paste a direct download URL to a prebuilt .zip containing archive/artifacts/usr/local/bin/texitcoind (+cli, tx, wallet). Works with any host — GitHub release assets, S3, your own server. A branch URL like /tree/<branch> won't work — that's source code, not a built binary. Your dev must cut a Release (or upload the zip somewhere) first.

▶Advanced Settings

dbcache (MB)

Max connections

addnode peers (one per line)

node1 ✓ node2 ✓ node3 ✓

Extra rpcallowip (comma or newline)

2. Deployment Output

Paste-to-shell Installer

Paste into your fresh Ubuntu 22.04 or 24.04 shell. It sends this small config block to the installer endpoint, streams back install.sh, and logs failures on the box at /var/log/txc-spinner-install.log.

Mainnet builds connect to node1.texitcoin.org:15740, node2.texitcoin.org:15740, node3.texitcoin.org:15740 out of the box.

curl

set -euo pipefail
curl -fsSL -X POST 'https://spinner.texitcoin.org/api/public/spinner/install' \
  -H 'content-type: application/json' \
  --data-binary @- <<'TXC_SPINNER_CONFIG' | sudo bash
{
  "chain": "txc",
  "moniker": "txc-node-01",
  "network": "mainnet",
  "p2pPort": 15740,
  "rpcPort": 15739,
  "rpcUser": "txc_admin",
  "rpcPassword": "",
  "txindex": true,
  "pruning": false,
  "pruneSizeMB": 5000,
  "ufw": true,
  "systemd": true,
  "dedicatedUser": true,
  "dbCacheMB": 450,
  "maxConnections": 125,
  "useOfficialPeers": true,
  "addnodes": "node1.texitcoin.org:15740\nnode2.texitcoin.org:15740\nnode3.texitcoin.org:15740",
  "extraRpcAllowIp": "",
  "installLatest": false,
  "releaseTag": "",
  "customZipUrl": "",
  "enableSwap": true,
  "swapSizeGB": 4,
  "enableCaddy": false,
  "caddyDomain": "",
  "caddyEmail": "",
  "phoneHome": true
}
TXC_SPINNER_CONFIG

Heads up: upstream doesn't publish SHA256 checksums for the release zip yet, so install.sh skips signature verification (marked with a TODO). Pin a known-good URL before piping to bash in production.

3. Day-to-day Commands

Common commands for operating your node after install. All snippets are pre-filled with the data dir and user from your config above — copy and paste as needed.

Service control

Start, stop, restart, and inspect the texitcoind systemd unit.

▶

Status

shell

sudo systemctl status texitcoind --no-pager

Start

shell

sudo systemctl start texitcoind

Stop

shell

sudo systemctl stop texitcoind

Restart

shell

sudo systemctl restart texitcoind

Enable on boot

shell

sudo systemctl enable texitcoind

Disable on boot

shell

sudo systemctl disable texitcoind

Logs

Tail journald output and the daemon's debug.log.

▶

Follow journal

shell

sudo journalctl -u texitcoind -f

Last 200 lines

shell

sudo journalctl -u texitcoind -n 200 --no-pager

Tail debug.log

shell

sudo tail -f /var/lib/texitcoin/debug.log

Errors only

shell

sudo grep -iE "error|warning" /var/lib/texitcoin/debug.log | tail -50

Chain & sync

Check sync progress, block height, and network info.

▶

Blockchain info

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 getblockchaininfo

Current block count

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 getblockcount

Best block hash

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 getbestblockhash

Network info

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 getnetworkinfo

Mempool info

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 getmempoolinfo

Uptime (seconds)

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 uptime

Peers

Inspect and manage peer connections.

▶

Connection count

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 getconnectioncount

Peer list (summary)

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 getpeerinfo | jq '.[] | {addr, subver, synced_blocks}'

Add a peer

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 addnode "host:15740" add

Disconnect a peer

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 disconnectnode "host:15740"

Wallet (basic)

Common wallet operations. Back up wallet.dat before doing anything destructive.

▶

List wallets

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 listwallets

Create wallet

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 createwallet "main"

New address

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 -rpcwallet=main getnewaddress

Balance

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 -rpcwallet=main getbalance

List transactions

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 -rpcwallet=main listtransactions "*" 20

Backup wallet

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 -rpcwallet=main backupwallet /var/lib/texitcoin/wallet-backup-$(date +%F).dat

Wallet (import keys / seed)

Import an existing WIF private key, an HD seed (BIP32 xprv), or restore from a wallet.dat backup. importprivkey / sethdseed will rescan the chain (slow on a fresh node — wait for sync first, or pass false to skip and rescan later).

▶

Create a fresh wallet to import into (disable auto keypool)

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 createwallet "imported" false false "" false false true

Load an existing wallet (if not already loaded)

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 loadwallet "imported"

Unlock wallet (only if encrypted) — 600s

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 -rpcwallet=imported walletpassphrase "YOUR_PASSPHRASE" 600

Import a WIF private key (rescans chain — can take a while)

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 -rpcwallet=imported importprivkey "YOUR_WIF_KEY_HERE" "label" true

Import a WIF without rescan (fast — run rescanblockchain later)

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 -rpcwallet=imported importprivkey "YOUR_WIF_KEY_HERE" "label" false

Set HD seed from existing xprv (BIP32 extended private key)

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 -rpcwallet=imported sethdseed true "YOUR_XPRV_HERE"

Import many keys at once (bulk, atomic)

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 -rpcwallet=imported importmulti '[{"scriptPubKey":{"address":"ADDRESS"},"timestamp":"now","keys":["WIF1","WIF2"]}]' '{"rescan":true}'

Import a watch-only address (no spending)

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 -rpcwallet=imported importaddress "ADDRESS_HERE" "label" true

Rescan chain from a height (after a no-rescan import)

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 -rpcwallet=imported rescanblockchain 0

Restore from a wallet.dat backup (stop daemon first!)

shell

sudo systemctl stop texitcoind
sudo mkdir -p /var/lib/texitcoin/wallets/restored
sudo cp /path/to/wallet-backup.dat /var/lib/texitcoin/wallets/restored/wallet.dat
sudo chown -R texitcoin:texitcoin /var/lib/texitcoin/wallets/restored
sudo systemctl start texitcoind
sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 loadwallet "restored"

Dump a WIF for an address (for backup / migration)

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 -rpcwallet=imported dumpprivkey "ADDRESS_HERE"

Dump entire wallet to a human-readable file

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 -rpcwallet=imported dumpwallet /var/lib/texitcoin/wallet-dump-$(date +%F).txt

Verify import: list addresses + balances in this wallet

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 -rpcwallet=imported listaddressgroupings && sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 -rpcwallet=imported getbalances

Maintenance

Upgrades, config reloads, and a graceful shutdown.

▶

Edit config

shell

sudo nano /var/lib/texitcoin/texitcoin.conf

Reload after config change

shell

sudo systemctl restart texitcoind

Graceful stop (RPC)

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 stop

Disk usage

shell

sudo du -sh /var/lib/texitcoin

Binary version

shell

texitcoind --version

Firewall (UFW)

Inspect and adjust the inbound P2P rule.

▶

Status

shell

sudo ufw status numbered

Allow P2P

shell

sudo ufw allow 15740/tcp

Remove P2P rule

shell

sudo ufw delete allow 15740/tcp

Sync troubleshooting

Use this when the daemon is running but block height isn't moving. Runs through the usual suspects: DNS, outbound reachability, peer count, and manual peer injection.

▶

Are we actually connected to peers?

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 getpeerinfo | jq 'length' && sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 getconnectioncount

Headers vs blocks (is it just slow, or stuck?)

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 getblockchaininfo | jq '{chain, headers, blocks, verificationprogress, initialblockdownload}'

Resolve the official seed hostnames

shell

getent hosts node1.texitcoin.org && getent hosts node2.texitcoin.org && getent hosts node3.texitcoin.org

Test outbound to :15740 (need nc: apt-get install -y netcat-openbsd)

shell

nc -vz -w 5 node1.texitcoin.org 15740
nc -vz -w 5 node2.texitcoin.org 15740
nc -vz -w 5 node3.texitcoin.org 15740

Force-add the seed peers by IP (bypasses DNS)

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 addnode "100.26.246.45:15740" onetry
sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 addnode "3.81.34.55:15740" onetry
sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 addnode "54.243.8.200:15740" onetry

Persist IP peers into texitcoin.conf and restart

shell

sudo tee -a /var/lib/texitcoin/texitcoin.conf > /dev/null <<'EOF'
addnode=100.26.246.45:15740
addnode=3.81.34.55:15740
addnode=54.243.8.200:15740
EOF
sudo systemctl restart texitcoind

Tail debug.log for peer / handshake errors

shell

sudo tail -n 200 /var/lib/texitcoin/debug.log | grep -iE "peer|connect|handshake|version|ban|disconnect" | tail -50

Handshake stuck: show recent network events

shell

sudo tail -n 500 /var/lib/texitcoin/debug.log | grep -iE "trying connection|connected|send version|receive version|version message|verack|handshake|disconnect|socket|checksum|magic|invalid|ban|misbehav|headers" | tail -100

Added-node connection status

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 getaddednodeinfo true

Turn on verbose P2P logging, then restart

shell

printf '
# Temporary sync debugging
debug=net
' | sudo tee -a /var/lib/texitcoin/texitcoin.conf
sudo systemctl restart texitcoind
sudo journalctl -u texitcoind -n 80 --no-pager

Check UFW status + default policies (inactive = nothing blocked)

shell

sudo ufw status verbose || echo "ufw not installed"

Check old node config for auth keys / shared secrets

shell

sudo grep -iEn "authkey|networkid|networkmagic|sharedkey|nodekey|privkey|secret" /var/lib/texitcoin/texitcoin.conf /etc/texitcoin/texitcoin.conf $HOME/.texitcoin/texitcoin.conf 2>/dev/null || echo "no auth-style keys found"

Look for network magic / wrong-network errors in debug.log

shell

sudo grep -iE "messagestart|wrong network|invalid header|bad magic|checksum|peer=.*disconnect|protocol" /var/lib/texitcoin/debug.log | tail -50

Binary version (compare against your old/working node)

shell

texitcoind --version && texitcoin-cli --version

Protocol version this node advertises

shell

sudo -u texitcoin texitcoin-cli -datadir=/var/lib/texitcoin -conf=/var/lib/texitcoin/texitcoin.conf -rpcport=15739 getnetworkinfo | jq '{version, subversion, protocolversion, localrelay, networkactive}'