Troubleshooting

If you have a problem or a question on XCP-ng, there's 2 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 articlesbelow here. 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

📄️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 a 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.