Troubleshooting
Common install and runtime issues.
- curl returns HTML: confirm you use
/install/*.shURLs and the host servestext/plain, not an SPA fallback page. - weavo-node download fails: set
WEAVO_NODE_BINARY_URLtohttps://panel.weavo.nl/releases/weavo-node-linux-<arch>orhttps://panel.weavo.nl/releases/<tag>/weavo-node-linux-<arch>or provideGITHUB_TOKENfor private GitHub releases. - GHCR image pull errors: check registry credentials and image tags on the cluster; verify outbound HTTPS from nodes.
- Ports / firewall: k3s requires 6443 between agents and servers; open ingress ports for your admin URL.
- Pinned scripts: export
WEAVO_SCRIPT_RAW_BASE=https://raw.githubusercontent.com/WeavoDev/weavopanel/main/scriptsto fall back to GitHub raw.