TrexzactylTrexzactyl Installer

Troubleshooting

Common issues and solutions for Trexzactyl installation.

Installation Issues

Permission Denied

If you encounter permission errors during installation:

sudo bash <(curl -s http://installer.trexz.xyz/install.sh)

Make sure you're running the installer with root or sudo privileges.

Port Already in Use

If ports 80 or 443 are already in use:

  1. Check what's using the port:
sudo lsof -i :80
sudo lsof -i :443
  1. Stop the conflicting service:
sudo systemctl stop apache2
# or
sudo systemctl stop nginx

Database Connection Failed

If the panel can't connect to the database:

  1. Verify MariaDB is running:
sudo systemctl status mariadb
  1. Check database credentials in .env file
  2. Ensure the database user has proper permissions

Wings Issues

Wings Won't Start

Check the Wings logs:

sudo journalctl -u wings -n 50

Common causes:

  • Docker not installed or not running
  • Firewall blocking required ports
  • Invalid configuration in /etc/pterodactyl/config.yml

Container Creation Failed

Ensure Docker is properly installed:

sudo docker ps

If Docker isn't working, reinstall it:

curl -sSL https://get.docker.com/ | CHANNEL=stable bash

SSL Certificate Issues

Certificate Generation Failed

  1. Verify your domain points to the server IP
  2. Ensure ports 80 and 443 are open
  3. Check Let's Encrypt rate limits

Certificate Renewal Failed

Check certbot logs:

sudo certbot renew --dry-run

Panel Issues

White Screen / 500 Error

  1. Check PHP-FPM status:
sudo systemctl status php8.1-fpm
  1. Check panel logs:
tail -n 100 /var/www/trexzactyl/storage/logs/laravel.log
  1. Clear cache:
cd /var/www/trexzactyl
php artisan cache:clear
php artisan config:clear

Queue Worker Not Processing

Restart the queue worker:

sudo systemctl restart pteroq

Check queue worker status:

sudo systemctl status pteroq

Getting Help

If you're still experiencing issues:

  1. Check the GitHub Issues
  2. Join our Discord
  3. Review the official documentation

Logs Location

Important log files:

  • Panel: /var/www/trexzactyl/storage/logs/
  • Wings: sudo journalctl -u wings
  • Nginx: /var/log/nginx/
  • PHP-FPM: /var/log/php8.1-fpm.log
  • MariaDB: /var/log/mysql/