Skip to main content

Troubleshooting

This document covers some known issues and the process to debug and fix them.

1. Player Avatar image not showing for Bedrock Edition Players.​

If you see broken image for bedrock edition players, it is mostly due to a Nginx configuration which prevents accessing any URL with . in it.

Open your Nginx configuration file for MineTrax (mostly /etc/nginx/sites-available/minetrax.conf) and find for below line.

/etc/nginx/sites-available/minetrax.conf
...

location ~ /\.(?!well-known).* {
   deny all;
}

...

Delete the above block of 3 lines and then restart Nginx.

sudo systemctl restart nginx

Check if the issue is fixed.

2. laravel.log permission issue.​

If you get some error like:

Error in exception handler: The stream or file "/var/www/minetrax/app/storage/logs/laravel.log" could not be opened: failed to open stream: Permission denied in /var/www/minetrax/bootstrap/compiled.php:8423

It is because of missing permission required to write logs. You need to make sure the ownership of the files belongs to the user who is running web server (in most cases its www-data).

You can simply run update.sh and it will fix permissions

sh update.sh

or manually, Give the permission by running below command.

chmod -R 775 /var/www/minetrax/storage/* var/www/minetrax/bootstrap/cache
chown -R $USER:www-data /var/www/minetrax

3. Player Stats are not getting tracked.​

If player stats are not getting tracked, it is mostly due to queue workers not working properly.

You can try fixing file permissions & then restarting queue workers. Run below command

sh update.sh
sudo supervisorctl restart all

Ping us on discord if issue persists

4. Minetrax taking too much CPU and Memory.​

If your queue workers are not working properly, it can cause high CPU and Memory usage.

Queue workers fails mostly due to permission issues. You can fix permission and then restart queue workers by running below command.

sh update.sh
sudo supervisorctl restart all

After that it should be fixed. Not not then check logs in /var/www/minetrax/storage/logs/ for any errors.

Feel free to ping us on discord

5. Out of Memory Error while Building Frontend Assets.​

info

This happen only if you rebuilding frontend assets.

Building frontend assets(npm run prod) is memory intensive task. If your server RAM where web is hosted is low (<2GB), the build process might get failed with message like Killed or ERR_WORKER_OUT_OF_MEMORY.

In such cases, you need to do two things.

  1. Increase node memory limit. Run this command

    export NODE_OPTIONS="--max-old-space-size=8192"

    This will increase node memory limit for your current session. You will have to run above for every new SSH Terminal you open to build frontend.

  2. Add Swap space to your server if there is none already. Follow this tutorial to add Swap space: https://www.digitalocean.com/community/tutorials/how-to-add-swap-space-on-ubuntu-20-04