Using local publisher

Walrus publisher on your machine

This dedicated page turns on a mode where the browser sends PUT /v1/blobs to http://127.0.0.1:… (your Walrus CLI publisher) first, then falls back to the default mainnet publishers. Use it when public publishers return 502 or while developing.

Settings are stored in localStorage for this origin only. This is not a relay server — it is still the same HTTP-publisher model; only the first endpoint points at your machine.

Configuration

Publisher base URL (no trailing slash)

Mixed content: if WalForms is served over https:// (e.g. Vercel or Netlify), the browser usually cannot call http://127.0.0.1. Serve this build over http://127.0.0.1:PORT or http://localhost:PORT on the same machine as the Walrus CLI.

Run the publisher (Walrus CLI)

Per Walrus docs — the publisher needs a wallet with SUI and WAL; example bind address 127.0.0.1:31416:

PUBLISHER_WALLETS_DIR=~/.config/walrus/publisher-wallets
mkdir -p "$PUBLISHER_WALLETS_DIR"
walrus publisher \
  --bind-address "127.0.0.1:31416" \
  --sub-wallets-dir "$PUBLISHER_WALLETS_DIR" \
  --n-clients 1

Or use walrus daemon with the same --bind-address flag to combine aggregator and publisher. Details: Operating a publisher.

Open builder Back to home