Loading

CWP aims at providing the best possible experience to both sys.admins, as well as end users who need an interface to interact with the server.

FREE Download | cPanel to CWP server convert

Installation Instructions

Setup Web Hosting platform with CWP

Installation guide

To avoid facing any issues, please make sure to read all of this instructions manual thoroughly prior to the installation process.

Control Web Panel (CWP) Installation Requirements

 

  • Important Notices

    • No Uninstaller Provided: Please be aware that CWP does not include an uninstaller. To remove the software after installation, a complete reinstallation of the server’s operating system is required.

    • Fresh OS Only: CWP must be installed on a clean, freshly installed operating system without any prior configurations or modifications.

  • Network Requirements

    • Static IP Only: We exclusively support static IP addresses.

    • Unsupported Networks: We do not support dynamic, sticky, or internal IP addresses

  • Recommended Performance

    • Optimized Hardware: For the best performance and stability, we recommend deploying CWP on a VPS or Dedicated Server through one of our official NOC Partners.

  • Only install CWP on a freshly installed operating system without any configuration changes

For best performance

...We suggest you to order a VPS or Dedicated servers with our NOC Partners.

Quick guide EL9/ Almalinux 9
  1. hostnamectl set-hostname srv.example.com
  2. dnf install epel-release -y
  3. dnf -y install wget
  4. dnf -y update
  5. reboot
  6. cd /usr/local/src
  7. wget http://centos-webpanel.com/cwp-el9-latest
  8. sh cwp-el9-latest
Quick guide CentOS 8/ Almalinux 8
  1. hostnamectl set-hostname srv.example.com
  2. yum install epel-release -y
  3. yum -y install wget
  4. yum -y update
  5. reboot
  6. cd /usr/local/src
  7. wget http://centos-webpanel.com/cwp-el8-latest
  8. sh cwp-el8-latest

System Requirements

Pre-Installation Checklist

Please ensure the following tasks are completed before beginning the installation process:

1. Configure Hostname

 

Your server’s hostname must be a Unique Fully Qualified Domain Name (FQDN).

  • Constraint: The hostname cannot be identical to any domain hosted on the server.

    • Example: If example.com is a domain on your server, use srv1.example.com as your hostname.

  • Setup Command: You can set your hostname using the following command (e.g., for srv1.example.com):

hostname srv1.example.com
2. Configure Server IP Addresses

 

Please define your primary and additional IP addresses, including the subnet mask and default gateway.

  • Required Information: If you do not have these details, contact your hosting or service provider for your specific network configuration.

  • Network Details Needed:

    • Static IP Address

    • Subnet Mask

    • Default Gateway

3. Software Requirements

CWP requires a clean, minimal installation of a supported operating system. Below are the compatible distributions and our recommendations for 2026:

  • Recommended Operating Systems

    OS Version Installation Type Notes
    AlmaLinux 8 & 9 Minimal / Boot Recommended Stable. The best overall choice for CWP in 2026.
    CentOS 7 Minimal Provides the most features and the CWP Secure Kernel.
    CentOS 8 & 9  Minimal / Boot Stable when used with our Custom CWP Repositories.

    Compatible (Alternative) Options

    • Rocky Linux 8 & 9 (Minimal/Boot): Compatible, but some issues may occur. We strongly recommend switching to AlmaLinux 8 or 9 for better stability.

    • Oracle Linux 7, 8, & 9 (Minimal/Boot): Supported, but for optimal performance, AlmaLinux remains the preferred choice.

    Note on CentOS 8 Stream: We maintain custom repositories that make CentOS 8 Stream a highly stable environment for CWP.

4. Hardware Requirements

    To ensure stability and access to all CWP features, your server must meet the following hardware specifications:

    Memory (RAM) Specifications

    • Minimum Requirement: A 64-bit operating system requires at least 2 GB of RAM.

    • Recommended Specification: We recommend 4 GB of RAM or more.

      • Note: This extra memory is necessary for high-resource features, such as real-time Anti-virus scanning for email.

    OS Downloads (Optional)

    If your hosting provider does not offer a pre-installed image, you can download the official ISO files here:

    Quick guide EL9/ Almalinux 9
    1. hostnamectl set-hostname srv.example.com
    2. dnf install epel-release -y
    3. dnf -y install wget
    4. dnf -y update
    5. reboot
    6. cd /usr/local/src
    7. wget http://centos-webpanel.com/cwp-el9-latest
    8. sh cwp-el9-latest
    Quick guide CentOS 8/ Almalinux 8
    1. hostnamectl set-hostname srv.example.com
    2. yum install epel-release -y
    3. yum -y install wget
    4. yum -y update
    5. reboot
    6. cd /usr/local/src
    7. wget http://centos-webpanel.com/cwp-el8-latest
    8. sh cwp-el8-latest

    Server Updates & Preparation

     

    1. Prepare the Server

     

    First, install the necessary packages required for the CWP installation process.

    yum -y install wget

    CentOS 7 repository update from mirror to vault (*required CentOS 7 ONLY)

    curl http://centos-webpanel.com/centos7_fix_repository|sh

    For AlmaLinux, Rocky Linux, and CentOS 8/Stream

    You may need to install the EPEL repository to access essential tools like wget:

    yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
    dnf install wget -y
    2. Perform a Full System Update

     

    A reboot is required to apply all updates and ensure the system is running on the latest kernel:

    yum -y update
    3. Reboot the Server

     

    Reboot your server so that all updates can take effect.

    reboot
    Quick guide EL9/ Almalinux 9
    1. hostnamectl set-hostname srv.example.com
    2. dnf install epel-release -y
    3. dnf -y install wget
    4. dnf -y update
    5. reboot
    6. cd /usr/local/src
    7. wget http://centos-webpanel.com/cwp-el9-latest
    8. sh cwp-el9-latest
    Quick guide CentOS 8/ Almalinux 8
    1. hostnamectl set-hostname srv.example.com
    2. yum install epel-release -y
    3. yum -y install wget
    4. yum -y update
    5. reboot
    6. cd /usr/local/src
    7. wget http://centos-webpanel.com/cwp-el8-latest
    8. sh cwp-el8-latest

    Installation

    You are now ready to begin the CWP installation process.

     

    Important Note on Duration

    Estimated Time: The CWP installer may take 30 minutes or longer to complete. This is because the system compiles Apache and PHP directly from the source code to ensure maximum performance and compatibility with your hardware.

    Installer for CentOS 7
    cd /usr/local/src
    wget http://centos-webpanel.com/cwp-el7-latest
    sh cwp-el7-latest
    Installer for CentOS 8/stream, Alma Linux, and Rocky Linux (recommended)
    cd /usr/local/src
    wget http://centos-webpanel.com/cwp-el8-latest
    sh cwp-el8-latest
    
    CWP Installer for Enterprise Linux 9 (EL9)

     

    Supported OS: CentOS 9 Stream, AlmaLinux 9, and Rocky Linux 9.

    PHP Version Support:
    Please note that in the EL9 release, legacy PHP versions have been removed to ensure better security and performance.

    CWP currently supports the following PHP versions: PHP 7.4 through PHP 8.4 and later

    cd /usr/local/src
    wget http://centos-webpanel.com/cwp-el9-latest
    sh cwp-el9-latest
    
    Optional Installer Arguments

    Available long name arguments
    –restart yes (for automatic restart after successfull install)
    –phpfpm [5.3|5.4|5.5|5.6|7.0|7.1|7.2|7.3|7.4] (you can use only one)
    –softaculous yes (install softaculous – script installer)

    Available short name arguments
    -r yes (for automatic restart after successfull install)
    -p [5.3|5.4|5.5|5.6|7.0|7.1|7.2|7.3|7.4] (you can use only one)
    -s yes (install softaculous – script installer)

    Example for centos 7 (you can combine short and long name arguments)

    sh cwp-el7-latest -r yes --phpfpm 7.3 --softaculous yes

    Any of this additionals can be also installed later from cwp gui.

    Reboot Server

    Once the installation is complete, you must reboot your server. This ensures that all system updates take effect and all CWP services start correctly.

    reboot
    Quick guide EL9/ Almalinux 9
    1. hostnamectl set-hostname srv.example.com
    2. dnf install epel-release -y
    3. dnf -y install wget
    4. dnf -y update
    5. reboot
    6. cd /usr/local/src
    7. wget http://centos-webpanel.com/cwp-el9-latest
    8. sh cwp-el9-latest
    Quick guide CentOS 8/ Almalinux 8
    1. hostnamectl set-hostname srv.example.com
    2. yum install epel-release -y
    3. yum -y install wget
    4. yum -y update
    5. reboot
    6. cd /usr/local/src
    7. wget http://centos-webpanel.com/cwp-el8-latest
    8. sh cwp-el8-latest
    Supported operating systems:

    CentOS Linux 7/8/9
    Rocky Linux 8/9
    Alma Linux 8/9
    Oracle Linux 7/8/9
    Red Hat Linux 7/8/9

    Cloud Linux Installer

    You need to have CloudLinux License.

    wget //repo.cloudlinux.com/cloudlinux/sources/cln/cldeploy
    sh cldeploy -k YOUR-KEY
    cd /usr/local/src/
    wget //dl1.centos-webpanel.com/files/c_scripts/cloudlinux.sh
    sh cloudlinux.sh

    After CloudLinux installer is done it will automatically reboot the server!!

    After reboot, you need to build CageFS and enable it
    /usr/sbin/cagefsctl --init
    cagefsctl --enable-all
    Quick guide EL9/ Almalinux 9
    1. hostnamectl set-hostname srv.example.com
    2. dnf install epel-release -y
    3. dnf -y install wget
    4. dnf -y update
    5. reboot
    6. cd /usr/local/src
    7. wget http://centos-webpanel.com/cwp-el9-latest
    8. sh cwp-el9-latest
    Quick guide CentOS 8/ Almalinux 8
    1. hostnamectl set-hostname srv.example.com
    2. yum install epel-release -y
    3. yum -y install wget
    4. yum -y update
    5. reboot
    6. cd /usr/local/src
    7. wget http://centos-webpanel.com/cwp-el8-latest
    8. sh cwp-el8-latest

    Post-Installation Configuration

     

    Log in to your CWP dashboard using the link provided at the end of the installation:

    • URL: http://SERVER-IP:2030/

    • Username: root

    • Password: YOUR_ROOT_PASSWORD

    2. Essential Setup Steps

    Before hosting your first website, complete these initial configuration tasks:

    • Set Root Email: Configure your administrator email to receive system alerts and notifications.

    • Create Hosting Packages: Set up at least one hosting package (or modify the default one) to define account limits.

    • Configure Shared IP: Assign your server’s public IP address as the primary shared IP.

    • Set Up Nameservers: Configure your nameservers (e.g., ns1.example.com and ns2.example.com) to manage DNS.

      Ready to Host

      You are now ready to start hosting domains! For advanced configuration and in-depth guides, please visit our official documentation:

      Quick guide EL9/ Almalinux 9
      1. hostnamectl set-hostname srv.example.com
      2. dnf install epel-release -y
      3. dnf -y install wget
      4. dnf -y update
      5. reboot
      6. cd /usr/local/src
      7. wget http://centos-webpanel.com/cwp-el9-latest
      8. sh cwp-el9-latest
      Quick guide CentOS 8/ Almalinux 8
      1. hostnamectl set-hostname srv.example.com
      2. yum install epel-release -y
      3. yum -y install wget
      4. yum -y update
      5. reboot
      6. cd /usr/local/src
      7. wget http://centos-webpanel.com/cwp-el8-latest
      8. sh cwp-el8-latest