Skip to main content

XUI.one Docs | API | Source Code

XUI.ONE Terminal Commands

Full guide to XUI.one terminal commands for service control, admin resets, backups, migration and license management.

📘 Overview

This guide provides the exact XUI.ONE terminal commands with inline comments, formatted for Ghost so that the Copy button appears in every code block.


🛠️ Service Commands

These commands control the XUI.ONE service status:

service xuione start      # Start XUI.ONE service
service xuione stop       # Stop XUI.ONE service
service xuione restart    # Restart XUI.ONE service
service xuione reload     # Reload XUI.ONE configurations

Alternatively, use the XUI-specific scripts:

/home/xui/service start   # Start the XUI.ONE service
/home/xui/service stop    # Stop the XUI.ONE service
/home/xui/status          # Show service status

🧰 Administrative Tools

XUI.ONE includes advanced tools for system-level administration:

/home/xui/tools               # List all available tools
/home/xui/tools rescue        # Generate emergency access code
/home/xui/tools user          # Create an emergency admin user
/home/xui/tools mysql         # Re-authorize MySQL load balancers
/home/xui/tools database      # Restore a blank database
/home/xui/tools migration     # Clean migration database
/home/xui/tools flush         # Clear all blocked IPs
/home/xui/tools ports         # Regenerate MySQL ports
/home/xui/tools access        # Regenerate access code in MySQL

💾 Backup and Restore

Use the following commands to create or restore database backups:

mysqldump -u root xui > backup.sql        # Create a full database backup
mysql -u root xui < path/backup.sql       # Restore an existing backup

👤 Admin User Reset

To reset the admin user to default credentials:

mysql
USE xui;
REPLACE INTO users(id, username, password, member_group_id, status, owner_id, date_registered)
VALUES(1, 'admin', '$6$rounds=20000$suiEqF8SRt0Zqs1hbOvS7RnwYR82q1B5VE7zC1HQFQcX9o983R21S4b2k61zVMW3');
⚠️ After reset, log in and change the password immediately.

🔄 Database Migration

To migrate an existing database to XUI.ONE:

mysql xui_migrate < /root/old-db.sql
/home/xui/bin/php/bin/php /home/xui/includes/cli/migrate.php
⚠️ Always backup your current database before migration.

🧪 Other Useful Commands

Check service status:

/home/xui/status

Access initial setup page:

http://your.server.ip:your-access-code

This guide includes all essential terminal commands for managing the XUI.ONE IPTV panel. Use them responsibly and maintain up-to-date backups before performing critical operations.