Skip to main content
Content Protection

This content is protected and intended for legitimate IPTV service providers. Unauthorized distribution or use is strictly prohibited.

🖥️ XUI.ONE Panel Management Guide

Note: This guide provides essential commands for managing your XUI.ONE panel. All commands should be executed in the /home/xui/ directory unless specified otherwise.

📋 Prerequisites​

  • Linux server with XUI.ONE installed (Ubuntu 18.04 or 20.04 recommended)
  • Root privileges or sudo access
  • Basic SSH and terminal knowledge
  • MariaDB installed (version 10.5.x recommended)

🚀 Essential Commands​

▶️ Start Services​

Starts all XUI.ONE panel services.

service xuione start
# Alternative method
/home/xui/service start

⏹️ Stop Services​

Gracefully stops all XUI.ONE panel services.

service xuione stop
# Alternative method
/home/xui/service stop

🔄 Restart Services​

Restarts all panel services (stops and starts).

service xuione restart

🔄 Reload Services​

Reloads configuration without stopping services.

service xuione reload

📊 Check Panel Status​

Displays the current status of XUI.ONE services.

/home/xui/status
# Alternative method
service xuione status

📊 Monitoring Commands​

📈 View Server Resources​

Check CPU, memory, and disk usage.

top -b -n 1 | head -n 20

🌐 Check Network Connections​

Monitor active connections to your server.

netstat -tulpn | grep -i xui

🛠️ Maintenance Commands​

🧹 Clean Temporary Files​

Clears temporary files to free up disk space.

/home/xui/tools/clean

🔄 Reset Panel​

Resets the panel to its default state. Warning: This may cause data loss, so back up first.

/home/xui/tools/reset

💾 Backup Panel Creates a backup of the XUI.ONE panel and database.

/home/xui/tools/backup

🔙 Restore Backup​

Restores a previously created backup.

/home/xui/tools/restore

🔒 Fixing Ownership and Permissions​

🔄 Reset File Ownership​

Reset ownership of all XUI.ONE files to the correct user and group:

chown -R xui:xui /home/xui/

🔧 Set Correct Permissions​

Set proper permissions for the XUI.ONE directory:

find /home/xui/ -type d -exec chmod 755 {} \;
find /home/xui/ -type f -exec chmod 644 {} \;
chmod -R 777 /home/xui/tmp
chmod +x /home/xui/service
chmod +x /home/xui/status
chmod +x /home/xui/tools/*

🔍 Verify Permissions​

Check current ownership and permissions:

ls -la /home/xui/

⚠️ Common Permission Issues​

  • If streams fail, check Nginx and PHP-FPM logs in /home/xui/logs/
  • If the panel shows 500 errors, verify file permissions
  • After updates, always reset permissions

📝 Important Notes​

  • Root Access: Most commands require root privileges. Use sudo or log in as the root user.
  • Caution with Resets: Commands like reset can erase data. Always back up using backup first.
  • Xtream-UI Differences: Unlike Xtream-UI, XUI.ONE uses /home/xui/ and service xuione for service management.
  • MySQL User: Verify your MySQL user in /home/xui/config/config.ini if user_iptvpro doesn't apply.
  • Backups: Regularly back up your panel using the backup command to avoid data loss.

💡 Tips​

  • Always back up your database before updates (mysqldump xui > backup.sql)
  • Monitor disk space with df -h
  • Check logs in /home/xui/logs/ for errors
  • Use screen or tmux for long-running commands

🔍 Troubleshooting​

  • If services fail to start, check the status with /home/xui/status
  • Ensure MariaDB is running (service mariadb status) before maintenance commands
  • For persistent issues, consult the XUI.ONE community or official support channels

Last updated: July 2025