Skip to content
ShinzoHub environment: Testnet

Host the network

Run a host.
Make data useful.

Receive signed chain data, run views, and serve queries to applications.

Set up a hostI already have a node

Install on your server. Register here when your node is running.

Your host

The link between data and applications

  1. 01

    Receive

    Signed data from generators

  2. 02

    Verify

    Check the data signatures

  3. 03

    Run views

    Shape data for applications

  4. 04

    Serve

    Answer GraphQL queries

Before you start

Get your node ready

Prepare your server, endpoints, and wallet. Then register your running node.

  1. 01

    Prepare your server

    Use a server with a public address. Check the hardware and network requirements before you install.

    Host requirements, opens in a new tab
  2. 02

    Install and back up

    Install the host and back up its identity key. Keep the same key when you update a registered host.

    Install a host, opens in a new tab
  3. 03

    Expose your endpoints

    Make registration and GraphQL reachable. Keep both public URLs ready for registration.

    Nginx and TLS, opens in a new tab
  4. 04

    Prepare your wallet

    Use a wallet on this app’s ShinzoHub network, with funds for transaction fees.

    Register a host, opens in a new tab
My node is running

After setup

Registration is the first step.

Join a pool, test your host, and keep the software up to date. The views your host serves depend on the pools it joins.

Understand pools, opens in a new tab

  1. 1Register your node on ShinzoHub
  2. 2Join a pool and sync its view
  3. 3Test a query, then maintain your host

A few useful answers

Troubleshooting guide, opens in a new tab

Is a host the same as a generator?
No. A generator reads and signs source-chain data. A host receives that data, runs views, and answers queries. Running a host does not require a validator node.
What costs should I expect?
You pay for your server and the network fees of transactions you submit. Do not treat testnet activity as a promise of payment.
Can I change my endpoint later?
Yes. Use the same wallet and node identity to register the new endpoint. Keep your identity key backup.
What happens after registration?
Join a pool for a view you want to serve, then test a query against your host. Registration alone does not mean your host is serving a view.