WolfStack Troubleshooting

Common issues and solutions for WolfStack server management. For WolfScale database replication issues, see WolfScale Troubleshooting.

Dashboard not loading

  • Check the service: systemctl status wolfstack
  • Verify port 8553 is accessible
  • Check logs: journalctl -u wolfstack -f

Nodes added but not seeing each other

After adding nodes to a cluster, they may not appear connected or may show as offline. This is normal — you need to update WolfNet connections:

  1. Click on your cluster name in the sidebar
  2. Go to Settings
  3. Click Update WolfNet Connections

This establishes encrypted networking between all nodes and propagates the configuration to every node in the cluster. See Clustering for more details.

Default cluster is called “Wolfstack”

This is expected. When you install WolfStack on the first node, it automatically creates a cluster named “Wolfstack”. This is just a virtual label — it does not affect functionality. To rename it:

  1. Click on the cluster name in the sidebar
  2. Go to Settings
  3. Edit the Cluster Name and save

You can then add your other nodes to this cluster as normal.

Not sure which node type to select when adding a node

It doesn’t matter. WolfStack automatically detects whether a node is running Proxmox and adjusts accordingly. The type field is just a label and can be changed at any time. Simply add the node and WolfStack will configure it correctly.

Containers can’t ping across nodes

  • Ensure WolfNet is running on all nodes: systemctl status wolfnet
  • Check routes: ip route | grep 10.10.10
  • Restart WolfStack: systemctl restart wolfstack
  • Update WolfNet connections from Cluster → Settings

Uninstalling WolfStack

The installer drops a local copy of the uninstaller at /usr/local/bin/wolfstack-uninstall, so you can run it even if your DNS or networking is broken.

sudo wolfstack-uninstall

By default this stops the service, removes the binary and the systemd unit, but preserves /etc/wolfstack/ (your config, secrets, license, cluster state) so you can reinstall over the top without losing your setup.

For a complete wipe (config, data, manifest log) add --purge:

sudo wolfstack-uninstall --purge

The full uninstaller (with options for also removing WolfNet, WolfProxy, WolfServe, WolfDisk, WolfScale) supports:

  • --all — remove every Wolf-suite component on the host
  • --all --purge — nuke from orbit, no config retained
  • --wolfnet, --wolfproxy, --wolfserve, --wolfdisk, --wolfscale — remove individual components

Each install also writes a manifest at /var/log/wolfstack/install-<timestamp>.log recording every package the installer added or upgraded. Read that file before uninstalling if you want to know exactly what will be left behind on your system.

Esc