Skip to content
minanodeBeta release

Run the web node yourself

Run the web node from a release you have checked, with its JavaScript and WASM served from your own computer.

Download and check the archive

The web node also runs at minaweb.org. This page runs the same devnet node from a release archive instead.

The web node is an experimental devnet node. Use only devnet keys. You need Python 3.11 or newer, and a current desktop Chrome or Chromium browser.

  1. Download mina-web-0.23.0.tar.gz, with SHA256SUMS and SHA256SUMS.sig from the same release.
  2. Before you unpack the archive, verify it as Verify the signature and the checksum describes.
  3. Unpack the archive and start its server:
tar -xzf mina-web-0.23.0.tar.gz
cd mina-web-0.23.0
python3 -B serve.py

The archive holds the page, its WASM, the prover files, and the genesis configuration. The node builds its verifier indexes when it starts, and needs no other code or circuit download. You still trust the release publisher, your browser, and your computer.

Open the node

Open 127.0.0.1:8080 and press Start. The page does not work if you open the HTML file directly.

Before it listens, the server checks every file against manifest.json. It listens only on 127.0.0.1. It sends the isolation headers that WASM threads need, and a Content-Security-Policy that lets the page fetch only from itself and its relays.

If port 8080 is busy, add --port 8081. To stop the server, press Ctrl-C. To check the unpacked files without starting the server, run python3 -B serve.py --verify-only.

Choose the relays

By default, the node dials the release's relays, which manifest.json lists. It dials only those, with discovery off. The relays see your network address, and so do the public STUN servers that the node uses, Google's among them. The archive has no TURN servers, so a network that blocks direct WebRTC blocks the node.

To use your own native devnet node as the relay, start it in another terminal from the bundle directory. Keep its data in the sibling directory below, so the bundle stays unchanged:

mina node --network devnet --work-dir ../mina-relay-data \
  --http-addr 127.0.0.1 --port 3000 --libp2p-port 8302 \
  --webrtc-signal-addr 127.0.0.1 --webrtc-signal-port 8303

Wait for the node to sync. Then read its public peer id from its P2P identity log line, and use it in place of PEER_ID:

python3 -B serve.py \
  --relay /ip4/127.0.0.1/tcp/8303/webrtc/http/p2p/PEER_ID

--relay replaces the release's relays without changing the signed files. To dial several relays, give --relay once for each. Give each relay as a DNS name or an IPv4 address. The server refuses IPv6, because a Content-Security-Policy cannot name an IPv6 address. After a change, restart the server and reload the page.

To set up a relay on another machine, follow Accept web node peers.