Logo
133.0.9

Contents:

  • Installation
    • Introduction
    • Prerequisites
    • Deployment of the Bootstrap node
    • Enable IP-in-IP Encapsulation
    • Cluster expansion
    • Post-Installation Procedure
    • Accessing Cluster Services
    • Advanced guide
    • Troubleshooting
      • Bootstrap Installation Errors
      • Pod and Service CIDR Conflicts
  • Operation
  • Developer Guide
  • Glossary
MetalK8s
  • »
  • Installation »
  • Troubleshooting

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
Next Previous

© Copyright 2026, Scality.

Built with Sphinx using a theme provided by Read the Docs.