• Home
• Run
• Run A Host
• Register

Register

How to register your Host with the Shinzo Network through the hosted or local registration app so it can serve Views publicly.

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.
   2. 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. See Key & identity management for where the key lives and how to back it up and 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.