Learn how to fix and avoid the “Unable to detect your OS” in CyberPanel. Our CyberPanel Support team is here to help you with your questions and concerns.

CyberPanel Error “Unable to detect your OS” | Fixed

Having trouble with the error “Unable to detect your OS” while installing CyberPanel?

Well, you have come to the right place. According to our Experts, this error indicates that the installation script cannot identify the operating system on our server. Since CyberPanel only supports specific OS versions, this detection is critical for installation.

The error typically appears as:

Unable to detect your OS…
CyberPanel is supported on [list of supported OS versions]…

Unsurprisingly, this error will cause the installation to fail. Thereby, making it impossible to use CyberPanel.

Furthermore, the error reveals a compatibility issue between your server’s OS and the supported versions by CyberPanel.

Let’s take a look at some of the common causes behind this error and how to fix them.

An Overview:

• Causes and Fixes
• 1. Unsupported OS Version
• 2. OS Release File Mismatch
• 3. Script Issues
• 4. Environment and Configuration Issues
• Prevention Tips
• How to Check Supported OS Versions Before Installation

Causes and Fixes

1. Unsupported OS Version

The server is running an OS version not supported by CyberPanel (e.g., Ubuntu 20.10).

Fix:

Check the official CyberPanel documentation for supported OS versions. If needed, reinstall the server with a compatible OS version.

2. OS Release File Mismatch

OS release files (e.g., `/etc/os-release`, `/etc/centos-release`) may not match the expected strings.
For example: On CentOS Stream 8, the file shows “CentOS Stream release 8” instead of “CentOS Linux 8”.

Fix:

We have to edit the release files as seen here:

sudo sed -i 's/CentOS Stream release 8/CentOS Linux 8/' /etc/centos-release
sudo sed -i 's/CentOS Stream release 8/CentOS Linux 8/' /etc/os-release


Alternatively, switch to AlmaLinux or RockyLinux, which are fully compatible.

3. Script Issues

The installation script might have bugs or outdated code, preventing proper OS detection.

Fix:

Ensure we are using the latest version of the CyberPanel installation script.

4. Environment and Configuration Issues

Server configurations or virtualization environments might interfere with OS detection.

Fix:

Ensure the server is clean and free from conflicting configurations. Also, confirm that the virtualization setup does not interfere with OS detection.

Prevention Tips

• Before installation, confirm the server’s OS version is supported by CyberPanel.
• Follow CyberPanel’s official installation guides and scripts to minimize errors.
• Ensure the OS is updated within the supported range.
• Try the installation in a virtual environment before deploying it on a production server.

How to Check Supported OS Versions Before Installation

Before installing CyberPanel, we can easily check if our server’s OS version is compatible. This step can save you from installation errors like “Unable to detect your OS.”

• Visit the Official CyberPanel Website:
  1. First, go to the CyberPanel website. https://cyberpanel.net
  2. Then, go to Documentation section, usually found in the top menu.
  3. Next, look for the Installation Requirements or Supported OS Versions page. The list will include compatible Linux distributions and their versions.
• Use the CyberPanel GitHub Repository
  1. Head to the CyberPanel GitHub repository. https://github.com/usmannasir/cyberpanel
  2. Then. go to the ReadMe.md or INSTALL.md file, which usually contains the latest information about supported OS versions.
  3. Check the compatibility list to ensure the server matches one of the specified distributions.
• Run the Pre-Installation Script:

  Use the following command to download and run the pre-installation script:

  wget -O check-os.sh https://raw.githubusercontent.com/usmannasir/cyberpanel/main/tools/check-os.sh
bash check-os.sh


  This script will output your OS version and whether it’s supported by CyberPanel.
• Check Supported Versions Using CLI

  Open the terminal and enter the following command to check the current OS version:

  cat /etc/os-release

  Compare this output with the supported OS versions listed in the CyberPanel documentation or GitHub page.

[Need assistance with a different issue? Our team is available 24/7.]

Conclusion

In brief, our Support Experts demonstrated how to fix and avoid the “Unable to detect your OS” while installing CyberPanel.