Troubleshooting

This section describes common issues users face during and after a MetalK8s installation.

If your issue is not presented here, create a GitHub issue or open a new GitHub discussion.

• Bootstrap Installation Errors
  • Bootstrap installation fails for no obvious reason
  • Errors after restarting the bootstrap node
  • Bootstrap fails and console log is unscrollable
  • Bootstrap fails with “Invalid networks:service CIDR - no route exists”
    • Configuring a default route:
    • Configuring a dummy interface:
• Pod and Service CIDR Conflicts

Todo

• Add Salt master/minion logs, and explain how to run a specific state from the Salt master.

• Add troubleshooting for networking issues.