documentation icon indicating copy to clipboard operation
documentation copied to clipboard

Added two "::: warning"s for two problems that I encountered while installing + One other minor edit

Open kaz-49 opened this issue 8 months ago • 3 comments

I encountered some problems while installing Pterodactyl Panel on Fedora Server 41, so I figured I'd add the solutions I found here. I'm quite sure that these apply to more RHEL/Fedora-based distros, but I'm afraid I haven't tested installing the Panel on other distros so I don't know.

I also changed the preexisting "::: tip" to a "::: warning", because I think that the information in that "::: tip" block sounds much more important than your average (potentially optional) tip.

kaz-49 avatar May 01 '25 07:05 kaz-49

I wonder whether its better to add these commands to the troubleshooting page?

Jcodeerd avatar May 01 '25 09:05 Jcodeerd

I think with this one (below), it should be fine to just add it to the troubleshooting page as you said (with some formatting edits of course).

::: warning If you complete the official Panel installation documentation but get a HTTP 500 error code and "Permission Denied" errors in /var/log/nginx/pterodactyl.app-error.log, you may need to run the following commands:

sudo chcon -R -t httpd_sys_rw_content_t storage
sudo chcon -R -t httpd_sys_rw_content_t bootstrap/cache

:::

With this one (below), though, the command that I have and the commands that are on the troubleshooting page both appear to be solutions for similar (or perhaps even the same) problems. I don't know which of these solutions are better security-wise, so it would be great to get some input from someone who actually knows SELinux. If we can't get ahold of that person though, I think it'd be fine to remove mine because I think (based on nothing but gut feeling) that the pre-existing one looks more secure.

::: warning If you get "Permission denied [tcp://127.0.0.1:6379]" in your laravel log (/var/www/pterodactyl/storage/logs/laravel-TODAYS-DATE.log), you may need to run the following commands:

sudo setsebool httpd_can_network_connect=1

:::

I want to keep the edit from ::: tip to ::: warning as-is because of the aforementioned reason.

::: warning You will need to change the fastcgi_pass path in the Nginx configuration to /var/run/php-fpm/pterodactyl.sock :::

Should I edit the PR to make these changes?

kaz-49 avatar May 05 '25 02:05 kaz-49

Thanks for the PR @kaz-49 :)

I'm going to test this and double-check the security aspect of this as it messes with SELinux. I'll get back to you after I've tested it.

rowansc1 avatar Sep 05 '25 18:09 rowansc1