Install a node (Ubuntu)¶
| Minimum | Recommended | |
|---|---|---|
| OS | Ubuntu 22.04 or 24.04 LTS, x86-64 | 24.04 LTS |
| CPU | 2 vCPU (AVX2 helps GhostRider) | 4+ vCPU for mining |
| RAM | 4 GB | 8 GB |
| Disk | 40 GB SSD (archive node) | 100 GB |
| Network | public IPv4, TCP 30303 | + UDP 30303 for discovery |
1. Download and verify¶
Obtain the release tarball and the network folder (genesis.json, genesis.json.profile.json,
GENESIS_MANIFEST.json, bootnodes.txt) from the network operator over a trusted channel.
sha256sum pqwerai-v8-testnet-rc1-linux-amd64.tar.gz # must equal the published value
tar -xzf pqwerai-v8-testnet-rc1-linux-amd64.tar.gz
cd pqwerai-v8-testnet-rc1-linux-amd64 && sha256sum -c SHA256SUMS
Builds are reproducible: two independent builds of the same commit produce bit-identical binaries.
2. Install¶
sudo ./share/vps/install.sh ../pqwerai-v8-testnet-rc1-linux-amd64.tar.gz <tarball-sha256> /path/to/network
Creates the pqwerai and pqwerai-signer users, /opt/pqwerai/releases/<rev> with /opt/pqwerai/current,
/var/lib/pqwerai (0700), /etc/pqwerai, systemd units, journald limits and logrotate, and verifies the genesis files
against the manifest.
3. Configure /etc/pqwerai/core.env¶
PQWERAI_DATADIR=/var/lib/pqwerai/core
PQWERAI_P2P_PORT=30303
PQWERAI_NAT=extip:203.0.113.10 # your public IP so peers can dial back
PQWERAI_MAXPEERS=25
PQWERAI_DISCOVERY=true # seeded from /etc/pqwerai/network/bootnodes.txt
PQWERAI_RPC_ADDR=127.0.0.1 # never bind RPC publicly; use the TLS proxy
PQWERAI_RPC_PORT=8545
PQWERAI_PASE_WORKERS=0 # 0 = canonical serial (default); 2..64 = PASE, consensus-neutral
PQWERAI_MINE=false
#PQWERAI_ETHERBASE=0x… # rewards address; keep its key off the server
PQWERAI_VERBOSITY=3
4. Firewall¶
Opens only P2P (and 80/443 with --https for the RPC proxy). Ports 8545 (RPC), 9545 (metrics) and signer traffic are
never public.
5. Start and check¶
sudo systemctl enable --now pqwerai-core pqwerai-exporter
pqwerai-health # chain 77240, manifest genesis, peers > 0, advancing head
pqwerai-cli -rpc http://127.0.0.1:8545 status
sudo systemctl stop pqwerai-core # graceful: up to 180 s to flush
A node refuses to start on a datadir created for another genesis, and cannot peer with nodes of another chain.
Windows¶
There is no native Windows Core. The Windows Wallet's Node page runs the same verified Linux build inside WSL2.
Sources at 72057fe3ec: testnet/release/vps/INSTALL.md · testnet/release/vps/config/core.env.example
Found a problem? Report a documentation issue · Build testnet-rc1+72057fe3ec