Quick Start Guide
Get Trexzactyl Panel up and running in minutes!
Prerequisites
System Requirements
Ubuntu 20.04/22.04/24.04 or Debian 11/12
Minimum 2GB RAM
Minimum 10GB disk space
Root or sudo access
Before You Start
Fresh server installation
Domain name configured
DNS pointing to server IP
Ports 80 and 443 open
Installation Steps
Step 1: Run the Installer
bash <(curl -s http://installer.trexz.xyz/install.sh)
Step 2: Select Installation Type
The installer will present you with a menu:
╔════════════════════════════════════════════════════════════╗
║ ║
║ TREXZACTYL INSTALLER ║
║ ║
╚════════════════════════════════════════════════════════════╝
[1] Install Panel
[2] Install Wings
[3] Install phpMyAdmin
[4] Setup Database Host
[5] Update Panel
[6] Uninstall Panel
[7] System Information
[8] Check Services
[9] Run Tests
[0] Exit
Select an option:
Choose 1 to install the panel.
Step 3: Provide Configuration
Answer the prompts:
- Domain name:
panel.example.com - SSL setup:
y(yes, recommended) - Email:
admin@example.com(optional) - Database name: Press Enter for default (
panel) - Database user: Press Enter for default (
trexzactyl) - Database password: Leave empty to auto-generate
- Create admin user:
y(recommended) - Admin details: Email, username, name, password
Step 4: Wait for Installation
The installer will:
- Install all dependencies
- Configure services
- Setup database
- Build frontend assets
- Configure SSL
- Create admin user
Installation Time
Typically takes 15-20 minutes. Grab a coffee!
Step 5: Access Your Panel
Once complete, access your panel:
https://panel.example.com
Login with your admin credentials.
Post-Installation Tasks
1. Configure Panel Settings
Navigate to Admin Panel → Settings and configure:
- Site name and description
- Email settings (SMTP)
- Registration settings
- Security options
2. Add Your First Location
Go to Admin Panel → Locations and create a location:
- Name: e.g., "US East"
- Short code: e.g., "us-east"
- Description: Optional
3. Add Your First Node
Go to Admin Panel → Nodes and add a node:
- Name: e.g., "Node 1"
- Location: Select the location you created
- FQDN: e.g., "node1.example.com"
- Memory, disk, and other allocations
4. Install Wings on Node
On your node server, run:
bash <(curl -s http://installer.trexz.xyz/install.sh)
Select option 2 to install Wings.
5. Create Your First Server
Go to Admin Panel → Servers and create a server:
- Select owner
- Choose server name
- Select node and allocations
- Choose egg (game type)
- Configure resources
Common Commands
Service Management
# Restart queue worker
systemctl restart trexzactyl
# Restart web server
systemctl restart nginx
# Check service status
systemctl status trexzactyl
View Logs
# Queue worker logs
journalctl -u trexzactyl -f
# Panel logs
tail -f /var/www/trexzactyl/storage/logs/laravel.log
# Nginx logs
tail -f /var/log/nginx/trexzactyl.error.log
Clear Caches
cd /var/www/trexzactyl
php artisan cache:clear
php artisan config:clear
php artisan view:clear
Next Steps
Need Help?
- Check the Troubleshooting Guide
- Review Common Issues
- Visit GitHub Issues
