CyberPanel/docs/UBUNTU_24_TROUBLESHOOTING.md

Ubuntu 24.04.3 LTS Troubleshooting Guide for CyberPanel

Overview

This guide provides Ubuntu 24.04.3 LTS-specific troubleshooting information for CyberPanel installation and operation issues.

System Information

• OS: Ubuntu 24.04.3 LTS (Noble Numbat)
• Architecture: x86_64
• Support Status: Full Support until April 2029
• Package Manager: APT (Advanced Package Tool)

Ubuntu-Specific Commands

System Status Checks

# Check Ubuntu version
lsb_release -a
cat /etc/os-release

# Check CyberPanel service status
sudo systemctl status lscpd

# Check Apache2 status (Ubuntu uses Apache2)
sudo systemctl status apache2

# Check if CyberPanel is accessible
curl -I http://localhost:8090

Package Management

# Update package lists
sudo apt update

# Upgrade system packages
sudo apt upgrade -y

# Install essential packages
sudo apt install -y curl wget git

# Check for broken packages
sudo apt --fix-broken install

# Clean package cache
sudo apt autoremove -y
sudo apt autoclean

Ubuntu-Specific Log Locations

# CyberPanel logs
tail -f /usr/local/lscp/logs/error.log

# Apache2 logs (Ubuntu default)
tail -f /var/log/apache2/error.log
tail -f /var/log/apache2/access.log

# System logs
tail -f /var/log/syslog
journalctl -u lscpd -f
journalctl -u apache2 -f

# Installation logs
tail -f /root/cyberpanel-install.log

Common Ubuntu 24.04.3 Issues

1. Package Installation Failures

Issue: APT package installation errors during CyberPanel setup

Symptoms:

• E: Unable to locate package errors
• E: Package has no installation candidate errors
• Repository connection failures

Solution:

# Update package lists
sudo apt update

# Fix broken packages
sudo apt --fix-broken install

# Clean package cache
sudo apt clean
sudo apt autoclean

# Retry installation
sudo ./install.sh

2. Apache2 Configuration Issues

Issue: Apache2 service conflicts or configuration problems

Symptoms:

• Apache2 fails to start
• Port 80/443 conflicts
• Configuration syntax errors

Solution:

# Check Apache2 configuration
sudo apache2ctl configtest

# Check for port conflicts
sudo netstat -tlnp | grep :80
sudo netstat -tlnp | grep :443

# Restart Apache2
sudo systemctl restart apache2

# Check Apache2 status
sudo systemctl status apache2

3. PHP Version Issues

Issue: PHP version compatibility problems

Symptoms:

• PHP version not supported
• Missing PHP extensions
• PHP configuration errors

Solution:

# Check current PHP version
php -v

# Install PHP 8.1 (recommended for CyberPanel)
sudo apt install -y php8.1 php8.1-cli php8.1-common php8.1-mysql php8.1-zip php8.1-gd php8.1-mbstring php8.1-curl php8.1-xml php8.1-bcmath

# Enable PHP 8.1
sudo a2enmod php8.1

# Restart Apache2
sudo systemctl restart apache2

4. Firewall Configuration (UFW)

Issue: Ubuntu's UFW firewall blocking CyberPanel ports

Symptoms:

• Cannot access CyberPanel web interface
• Connection refused errors
• Port access denied

Solution:

# Check UFW status
sudo ufw status

# Allow CyberPanel ports
sudo ufw allow 8090/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 21/tcp
sudo ufw allow 25/tcp
sudo ufw allow 53/tcp
sudo ufw allow 587/tcp
sudo ufw allow 993/tcp
sudo ufw allow 995/tcp

# Enable UFW if not already enabled
sudo ufw enable

5. SystemD Service Issues

Issue: CyberPanel service not starting properly

Symptoms:

• systemctl status lscpd shows failed
• Service won't start on boot
• Service dependency errors

Solution:

# Check service status
sudo systemctl status lscpd

# Check service logs
sudo journalctl -u lscpd -f

# Reload systemd configuration
sudo systemctl daemon-reload

# Restart CyberPanel service
sudo systemctl restart lscpd

# Enable service to start on boot
sudo systemctl enable lscpd

6. Permission Issues

Issue: File permission problems specific to Ubuntu

Symptoms:

• Permission denied errors
• Cannot write to directories
• File ownership issues

Solution:

# Check file permissions
ls -la /usr/local/CyberCP/

# Fix ownership (replace 'cyberpanel' with actual user)
sudo chown -R cyberpanel:cyberpanel /usr/local/CyberCP/

# Fix permissions
sudo chmod -R 755 /usr/local/CyberCP/

# Check user groups
groups cyberpanel

Ubuntu-Specific Diagnostic Commands

System Information

# Check Ubuntu version and details
lsb_release -a
cat /etc/os-release

# Check kernel version
uname -r

# Check system architecture
arch
lscpu

Network Configuration

# Check network interfaces
ip addr show
ip route show

# Check DNS resolution
nslookup google.com
dig google.com

# Test connectivity
ping -c 4 google.com

Disk and Memory Usage

# Check disk usage
df -h
du -sh /usr/local/CyberCP/

# Check memory usage
free -h
cat /proc/meminfo

# Check swap usage
swapon -s

Ubuntu 24.04.3 Specific Considerations

1. Snap Package Conflicts

Ubuntu 24.04.3 comes with many snap packages that might conflict:

# Check for snap packages
snap list

# Remove conflicting snap packages if needed
sudo snap remove package-name

2. SystemD-Resolved

Ubuntu 24.04.3 uses systemd-resolved for DNS:

# Check DNS resolution
systemd-resolve --status

# Restart DNS resolver if needed
sudo systemctl restart systemd-resolved

3. AppArmor

Ubuntu 24.04.3 has AppArmor enabled by default:

# Check AppArmor status
sudo aa-status

# Check AppArmor logs
sudo dmesg | grep apparmor

Performance Optimization for Ubuntu 24.04.3

System Optimization

# Optimize APT for faster package installation
echo 'APT::Install-Recommends "false";' | sudo tee /etc/apt/apt.conf.d/99-no-recommends

# Enable APT caching
echo 'APT::Cache-Limit "100000000";' | sudo tee /etc/apt/apt.conf.d/99-cache-limit

Apache2 Optimization

# Edit Apache2 configuration
sudo nano /etc/apache2/apache2.conf

# Add these optimizations:
ServerTokens Prod
ServerSignature Off
KeepAlive On
MaxKeepAliveRequests 100
KeepAliveTimeout 5

Getting Help for Ubuntu 24.04.3

Ubuntu-Specific Resources

• Ubuntu Documentation: https://help.ubuntu.com/
• Ubuntu Forums: https://ubuntuforums.org/
• Ask Ubuntu: https://askubuntu.com/

CyberPanel Resources

• General Troubleshooting: Troubleshooting Guide
• Complete Guides: Guides Index
• CyberPanel Forums: https://community.cyberpanel.net

System Logs to Check

# Ubuntu system logs
sudo journalctl -xe
sudo dmesg | tail -50

# CyberPanel specific logs
tail -f /usr/local/lscp/logs/error.log
tail -f /usr/local/CyberCP/logs/cyberpanel.log

---

Note: This guide is specifically tailored for Ubuntu 24.04.3 LTS. For other Ubuntu versions or operating systems, refer to the appropriate OS-specific troubleshooting guide.