Self-serve node onboarding

This page prepares a Windows laptop/PC, Linux box, or cloud VM without remote access. The installer downloads the CLI, verifies the checksum when available, generates local identities, opens firewall rules when possible, and writes a safe join request for the coordinator.

Windows laptop or PC: Step 1

Open Terminal as Administrator: right-click Start, choose Terminal (Admin) or Windows PowerShell (Admin), then paste this one line and press Enter.

$u='https://mindchain.network/onboard/install-windows.ps1'; $p="$env:TEMP\mindchain-install.ps1"; iwr $u -OutFile $p; powershell -ExecutionPolicy Bypass -File $p -Mode both

When it finishes, File Explorer opens with the file you need selected:

C:\mindchain\join-request.json

Send only join-request.json to the coordinator. Keep the PowerShell window open if there is an error; send the error text instead of guessing.

Never send C:\mindchain\identity\*, identity.borsh, or any passphrase.

Windows laptop or PC: Step 2

After the coordinator sends back a machine-specific config bundle zip, open Terminal (Admin) again and run this one line. It opens a file picker; choose the returned zip.

$u='https://mindchain.network/onboard/install-bundle-windows.ps1'; $p="$env:TEMP\mindchain-install-bundle.ps1"; iwr $u -OutFile $p; powershell -ExecutionPolicy Bypass -File $p -RunNow

The same second step can also be started by double-clicking:

C:\mindchain\scripts\install-returned-bundle.cmd

After the node starts, open the local dashboard on that machine:

http://127.0.0.1:31104/dashboard

Linux machine or cloud VM: Step 1

On Ubuntu/Debian/Fedora/RHEL, run as root:

curl -fsSL https://mindchain.network/onboard/install-linux.sh -o /tmp/mindchain-install.sh
sudo bash /tmp/mindchain-install.sh --mode both

For cloud providers, paste this user-data into the VM's cloud-init/custom-data box:

https://mindchain.network/onboard/cloud-init-node.yaml

Then send only this file to the coordinator:

/var/lib/mindchain/join-request.json

Do not send /var/lib/mindchain/identity/** or any passphrase.

Linux machine or cloud VM: Step 2

Place the returned config bundle under /var/lib/mindchain/config, keep it owned by mindchain:mindchain, then start the dormant service:

sudo chown -R mindchain:mindchain /var/lib/mindchain/config
sudo systemctl start mindchain-node
journalctl -u mindchain-node -f

When the validator starts, open http://127.0.0.1:31104/dashboard on the node machine to check sync, peers, firewall hints, join-request JSON, and the log tail.

Constraint

A new validator cannot join an already-running MindChain chain unless its public key is already in that chain's genesis/network descriptor. This installer prepares the machine and join request; it does not fake live admission into devnet-0.