CCPanel Documentation v2.0
Welcome to the official CCPanel documentation. This guide covers installation, license activation, and API usage.
System Requirements
Before installing CCPanel, make sure your server meets the following requirements.
Supported Operating Systems
Ubuntu
Debian
AlmaLinux
Rocky Linux
CentOS
RHEL
CloudLinux
Scientific Linux
Minimum Hardware
Installation
Download and run the installer as root on a fresh server:
wget -O ccpanel-install.sh https://install.ccpanel.net/latest
bash ccpanel-install.sh
The installer will detect your OS and configure everything automatically. Installation typically takes 5–10 minutes. Once complete, you'll see your panel URL and login credentials.
CCPanel installed successfully!
Panel URL: https://your-server-ip:2083
Username: admin
Password: generated-password
License Activation VPS / Dedicated
Once the installer finishes, CCPanel runs in an unlicensed trial mode for 24 hours. Activate it with your license key before that window ends. Follow the steps in order — skipping server prep is the most common reason activation fails.
Step 1 — Update your server first
Always update OS packages before activating. An outdated kernel or missing library is the #1 cause of activation failures.
# Ubuntu / Debian
sudo apt update && sudo apt upgrade -y
# AlmaLinux / CentOS / RHEL
sudo dnf update -y
If the update installed a new kernel, reboot once before continuing:
sudo reboot
Step 2 — Check required ports are open
If you're behind a cloud firewall (AWS, DigitalOcean, etc.), open these ports before activating:
- 2083 — Panel UI (HTTPS)
- 2087 — Admin panel (HTTPS)
- 443 & 80 — Web traffic + Let's Encrypt
- Outbound 443 to
license.ccpanel.net
# UFW (Ubuntu)
sudo ufw allow 80,443,2083,2087/tcp
sudo ufw reload
# firewalld (AlmaLinux/CentOS)
sudo firewall-cmd --add-port=80/tcp --add-port=443/tcp --add-port=2083/tcp --add-port=2087/tcp --permanent
sudo firewall-cmd --reload
Step 3 — Confirm hostname & server clock
hostname -f
timedatectl
If the clock is off by more than a couple of minutes, sync it — incorrect system time causes license signature failures:
sudo timedatectl set-ntp true
Step 4 — Activate your license
Get your license key from my.dhakaitclub.com → Services → CCPanel, then run:
sudo ccpanel license --activate YOUR_LICENSE_KEY
License activated successfully!
Plan: Professional
Bound IP: 203.0.113.42
Expires: 2027-06-24
Status: ACTIVE
Check status anytime:
sudo ccpanel license --status
Step 5 — Moving to a new server?
Release the license on the old server first:
sudo ccpanel license --release
Then run --activate on the new server.
• "Connection timed out" — outbound port 443 to license.ccpanel.net is blocked. Check Step 2.
• "Signature mismatch" — server clock is wrong. Check Step 3.
• "License already in use" — release from old server (Step 5) or contact support to force-release.
Quick Start Guide
After installation and activation, follow these steps to get your first website running:
- Log in to your panel at
https://your-ip:2083 - Add your domain under Domains → Add Domain
- Point your domain's DNS A record to your server IP
- Enable SSL under SSL → Issue Certificate
- Install WordPress or your app via Apps → App Installer
REST API
CCPanel provides a full REST API to automate account and server management. All API calls require authentication via an API token generated from Settings → API Keys in your panel.
# Create a new hosting account
POST /api/v1/accounts
Authorization: Bearer YOUR_API_TOKEN
Content-Type: application/json
{
"username": "client1",
"password": "secure123",
"email": "client@example.com",
"domain": "example.com",
"plan": "professional"
}
WHMCS Module
The CCPanel WHMCS module enables automatic provisioning, suspension, and termination of hosting accounts when orders are placed in WHMCS.
- Download the module from your CCPanel dashboard under Reseller → WHMCS Module
- Upload to
/modules/servers/in your WHMCS directory - Go to Setup → Products → Servers and add your CCPanel server
- Enter your panel URL and API token, then click Test Connection