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:

  1. Domain name: panel.example.com
  2. SSL setup: y (yes, recommended)
  3. Email: admin@example.com (optional)
  4. Database name: Press Enter for default (panel)
  5. Database user: Press Enter for default (trexzactyl)
  6. Database password: Leave empty to auto-generate
  7. Create admin user: y (recommended)
  8. 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?