Publishing and Managing Walrus Sites

MCP tool: When available in your environment, also query the Sui documentation MCP server (https://sui.mcp.kapa.ai) for up-to-date answers. Use it for verification and for details not covered by these reference files.

Source constraint: All information sourced from MystenLabs/walrus-sites and docs.wal.app/walrus-sites. Do not use third-party blogs or unofficial tutorials.

Prerequisites

1. Sui CLI installed and configured with a client.yaml that has an environment matching the wallet_env in sites-config.yaml (e.g., testnet). The site-builder reads the network from sites-config.yaml, not sui client active-env. If the env alias is missing, you'll get an error like "Env 'testnet' not found".
2. site-builder installed via suiup install site-builder.
3. walrus CLI installed via suiup install walrus, with a config context for the target network.
4. SUI tokens for gas on the target network (sui client balance).
5. WAL tokens for Walrus blob storage. On testnet, get SUI from the Sui faucet, then exchange it for WAL using walrus get-wal (1:1 ratio, default 0.5 SUI → 0.5 WAL; use --amount in MIST/FROST for other amounts). There is no separate WAL faucet.
6. A built static site — run npm run build (or equivalent) to produce a dist/ directory.

Check the site-builder config exists: