TrexzactylTrexzactyl Installer

System Requirements

Ensure your system meets these requirements before installing Trexzactyl.

Operating System

Supported Distributions

  • Ubuntu: 20.04 LTS, 22.04 LTS, 24.04 LTS
  • Debian: 11 (Bullseye), 12 (Bookworm)

Not Supported

  • CentOS / RHEL
  • Fedora
  • Arch Linux
  • Windows (use WSL2 or VM)
  • macOS

Hardware Requirements

Minimum (Testing/Development)

  • CPU: 2 cores
  • RAM: 2GB
  • Disk: 10GB
  • Network: 10Mbps

Recommended (Small Production)

  • CPU: 4 cores
  • RAM: 4GB
  • Disk: 20GB SSD
  • Network: 100Mbps

Recommended (Large Production)

  • CPU: 8+ cores
  • RAM: 8GB+
  • Disk: 50GB+ SSD
  • Network: 1Gbps

Software Requirements

Automatically Installed

The installer handles these:

  • PHP 8.1+
  • Composer 2.x
  • Node.js 20.x
  • MariaDB 10.11
  • Nginx
  • Redis
  • Certbot
  • Docker (for Wings)

Required Access

  • Root or sudo privileges
  • SSH access
  • Internet connection

Network Requirements

Domain Name

  • Valid domain name (for SSL)
  • DNS A record pointing to server IP
  • Propagated DNS (can take up to 48 hours)

Ports

Panel:

  • 80 (HTTP)
  • 443 (HTTPS)

Wings:

  • 8080 (Wings API)
  • 2022 (SFTP)
  • 25565-25665 (Game servers - example range)

Firewall

  • Ports must be open in firewall
  • No conflicting services on required ports
  • Proper NAT configuration (if behind router)

Pre-Installation Checklist

Before running the installer:

  • [ ] Supported OS installed
  • [ ] Root/sudo access available
  • [ ] Domain name configured
  • [ ] DNS pointing to server
  • [ ] Ports 80 and 443 open
  • [ ] No existing web server (Apache/Nginx)
  • [ ] No existing PHP installation conflicts
  • [ ] Sufficient disk space
  • [ ] Stable internet connection

Checking Your System

Check OS Version

lsb_release -a

Check Available RAM

free -h

Check Disk Space

df -h

Check CPU Cores

nproc

Check Open Ports

sudo netstat -tlnp | grep -E ':(80|443|8080|2022)'

Check DNS

nslookup your-domain.com

Common Issues

Insufficient Resources

If your server doesn't meet minimum requirements:

  • Upgrade server resources
  • Use a VPS with adequate specs
  • Consider managed hosting

Port Conflicts

If ports are already in use:

# Check what's using port 80
sudo lsof -i :80

# Stop conflicting service
sudo systemctl stop apache2

DNS Not Propagated

Wait for DNS propagation:

  • Can take up to 48 hours
  • Check with: nslookup your-domain.com
  • Use DNS Checker

Next Steps

Once your system meets all requirements, proceed to the Quick Start Guide.