Troubleshooting

If you have a problem or a question on XCP-ng, there are two options: community support (mostly on XCP-ng Forum) or pro support.

The 3-Step-Guide

Here is our handy 3-Step-Guide:

1. Check the logs. Check your settings. Check all the articles below. If you already did, proceed to Step 2.
2. Get help at our Forum or get help on Discord or on IRC and provide as much information as you can:
   • ☑️ What did you exactly do to expose the bug?
   • 🚀 XCP-ng Version
   • 🖥️ Hardware
   • 🏭 Infrastructure
   • 📰 Logs
   • 📺 Screenshots
   • 🛑 Error messages
3. Share your solution on the forum, others can benefit from your experience.

tip

Pro Support: if you have subscribed to Pro support, well, don't hesitate to use it! We are also here to assist you BEFORE you have any problem

📄️Advanced host troubleshooting

Techniques for the hard cases: a host that doesn't boot, kernel or hypervisor crashes, and getting diagnostics out of a machine you can barely reach. For everyday issues, start with the 3-Step-Guide and the log files page.

📄️After Upgrade

The Server stays in Maintenance Mode

📄️Common Problems

Here is a list of common problems.

📄️Installation and upgrade

Upgrade here designates an upgrade using the installation ISO

📄️Log files

On an XCP-ng host, like in most Linux/UNIX systems, the logs are located in /var/log. XCP-ng does not use journald for logs, so everything is in /var/log directly.

🗃Storage

3 items

📄️High availability (HA)

High Availability (HA) is designed to automatically restart protected virtual machines in case a host fails. While this helps improve resilience, there are situations where HA may behave unexpectedly, prevent actions from completing, or make recovery more complex.

📄️Windows Guest Tools

Common issues and topics related to Windows Guest Tools.

🗃XAPI

2 items