• Home
• Run
• Run A Host
• Register

Register

To participate in the Shinzo Network and make your View publicly available, you need to register your Host. Registration is an on-chain transaction on ShinzoHub, so you need a wallet with a small amount of SHNZ to cover the transaction fee. Get testnet SHNZ from the faucet.

Add the Shinzo Testnet to your wallet

Add the Shinzo Testnet to your browser wallet with the following values:

Register with the hosted app

The hosted Registration app runs from any browser and doesn't require port forwarding, so it's the easiest path for Hosts reachable from the public internet.

1. Start your Host client with the health/registration port published (-p 8080:8080) and open inbound TCP 8080 in your firewall. The registration app is served on port 8080, and the public Hosts dashboard also probes http://<your-server-ip>:8080/health to decide whether your Host shows as online. If 8080 isn't reachable from the internet, your Host client shows as offline even while it's running fine.
2. Open the Registration app and select Connect to connect your wallet.
3. Choose Host as the role and fill in the requested details.
4. Submit your registration and confirm the transaction in your browser wallet. You should see a successful registration notification.

Register with the local registration app

If your Host is on a private network or you'd rather not route registration through the hosted app, the Host client serves its own registration app on port 8080.

1. Start your Host client with the health/registration port published (-p 8080:8080) and open inbound TCP 8080 in your firewall. The registration app is served on port 8080, and the public Hosts dashboard also probes http://<your-server-ip>:8080/health to decide whether your Host shows as online. If 8080 isn't reachable from the internet, your Host client shows as offline even while it's running fine.

2. Open the registration page and select Connect to connect your wallet.

   Info

   If your Host is running on a remote server (Hetzner, DigitalOcean, GCP, AWS, etc.), use SSH local port forwarding to access the registration page. 1. On your local machine, run ssh -L 8080:localhost:8080 user@your-server-ip. 1. Open http://localhost:8080/registration-app in your browser.

3. Click Register as Host and fill out all the details.

4. Submit your registration and confirm the transaction in your browser wallet. You should see a successful registration notification.

Register with the CLI

We're working on allowing Hosts to register their clients through the CLI using cast. We'll announce it once it's available.

Back up your node identity key

This key is your Host's identity on the network. If you lose it without a backup, you cannot restore your Host with the same identity.

• Store a secure backup of the key.
• In a recovery scenario, restore it to the same path your Host reads keys from: ~/.defra/keys for a source build, or the directory you mounted to /app/.defra/keys for Docker. See backing up your keys in the FAQ for the details per run mode.
• Use the same keyring secret. Your identity depends on both the key files and the keyring secret, so a backup of the keys alone is not enough to recover it.

Need help

• For onboarding and technical support, join the Shinzo Discord.
• To report a documentation bug or request a feature, open an issue in the docs repo.
• For a technical issue with the Host client, open an issue in the shinzo-host-client repo.