Installation Guide

Complete step-by-step instructions for installing JIOCP Panel

System Requirements

Operating System

  • Ubuntu 20.04 or later
  • Debian 10 or later
  • CentOS 7 or later
  • Any modern Linux distribution

Hardware

  • CPU: 2 cores minimum
  • RAM: 2GB minimum, 4GB recommended
  • Disk: 5GB+ for compilation
  • Network: Active internet connection

Access

  • Root or sudo access
  • SSH access recommended
  • Port 9292 available
  • Ports 80/443 optional

Installation Steps

  1. Download JIOCP Panel

    Download the complete JIOCP Panel package containing all installation scripts and files.

    wget https://jiocp.com/install/jiocp-panel.zip
unzip jiocp-panel.zip
cd jiocp-panel

  2. Review Installation Guide

    Before starting installation, read the included documentation to understand the process:

    • 00_READ_ME_FIRST.txt - Start here
    • QUICKSTART_INSTALL.md - Quick 3-step process
    • INSTALLATION.md - Complete detailed guide

  3. Run Installation Script

    Execute the automated installation script with root privileges:

    sudo bash install.sh

    The script will automatically:

    • Check system requirements
    • Install dependencies
    • Create jiocp user
    • Compile Nginx 1.26.0
    • Compile PHP-FPM 8.3.6
    • Download application files
    • Configure systemd services

  4. Wait for Compilation

    Installation takes 20-60 minutes depending on your system. The script will show progress for:

    • Dependency installation
    • Nginx compilation (takes longest)
    • PHP-FPM compilation
    • Service configuration

  5. Note Installation Summary

    After completion, the script shows your installation details including your real server IP:

    Installation Summary
====================

Panel Path: /usr/local/jiocp
Panel Port: 9292
Panel User: jiocp
Nginx: 1.26.0
PHP: 8.3.6

Access Your Panel:
  URL:     http://YOUR_SERVER_IP:9292
  Local:   http://localhost:9292

  6. Start Services

    Start the JIOCP Panel services:

    sudo jiocp start

    Check status:

    sudo jiocp status

  7. Access Your Panel

    Open your web browser and navigate to your panel using the real IP shown in the installation summary:

    http://YOUR_SERVER_IP:9292

    You'll see the JIOCP Control Panel dashboard where you can manage domains, servers, and configuration.

Manual Installation (Advanced Users)

If automated installation doesn't work, follow these manual steps. For detailed instructions, see INSTALLATION.md.

1. Install Dependencies

sudo apt-get update
sudo apt-get install -y build-essential libpcre3 libpcre3-dev \
    zlib1g zlib1g-dev libssl-dev libgd-dev libgeoip-dev \
    wget curl git unzip python3 sudo

2. Create User

sudo useradd -m -s /bin/bash -d /home/jiocp jiocp
echo "jiocp ALL=(ALL) NOPASSWD: ALL" | sudo tee /etc/sudoers.d/jiocp
sudo chmod 440 /etc/sudoers.d/jiocp

3. Create Directory Structure

sudo mkdir -p /usr/local/jiocp/{nginx,php,html,logs,bash,config}
sudo chown -R jiocp:jiocp /usr/local/jiocp
sudo chmod -R 755 /usr/local/jiocp

4. Download Panel Files

cd /tmp
wget https://jiocp.com/install/panel.zip
unzip panel.zip
sudo cp -r panel/* /usr/local/jiocp/

5. Compile Nginx

See INSTALLATION.md for complete Nginx compilation instructions with all modules.

6. Compile PHP-FPM

See INSTALLATION.md for complete PHP-FPM compilation instructions with all extensions.

7. Configure Services

Copy systemd service files and enable autostart:

sudo cp jiocp*.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable jiocp jiocp-nginx jiocp-php-fpm

Troubleshooting

Installation Failed?

Check the error message and try these solutions:

  • Missing dependencies: Ensure all system updates are installed: sudo apt-get update && sudo apt-get upgrade
  • Port 9292 in use: Check if another service is using port 9292: sudo lsof -i :9292
  • Compilation error: Check available disk space: df -h
  • Permission denied: Ensure you're running with sudo: sudo bash install.sh

Services Not Starting?

Check logs and service status:

sudo jiocp status
sudo jiocp logs
sudo systemctl status jiocp-nginx
sudo systemctl status jiocp-php-fpm

Can't Access Panel?

Verify services are running and check your IP:

sudo jiocp status
hostname -I
sudo ufw allow 9292  # If using firewall

After Installation

✓ Verify Installation

Check that your panel is accessible and all services are running correctly.

sudo jiocp status
sudo jiocp info

⚙️ Configure Settings

Customize your installation by editing configuration files.

sudo nano /usr/local/jiocp/nginx/conf/nginx.conf
sudo nano /usr/local/jiocp/php/etc/php.ini

📚 Read Documentation

Explore comprehensive guides for features and configuration.

  • CONFIG_USAGE.md
  • IP_DETECTION_GUIDE.md
  • PANEL_ZIP_CONTENTS.md