Skip to main content

Troubleshooting common problems

Placeholder page is displayed instead of the website

There could be several reasons for this. The most common ones are:

  • The domain name of your website points to a third-party server

    First of all, it's worth making sure that no typos were made when adding A and AAAA records to the domain zone (DNS).

  • The domain name of the website points to a server where this website does not exist

    Please ensure that your website is created on the server. To create a new empty site, please refer to the manual.

  • You're trying to access your website using HTTPS, but the website does not use an SSL certificate

    This is a common issue for Cloudflare users who are using the Full encryption mode. You should use an SSL certificate or access the website via http:// with disabled Full mode.

    You are able to issue a free SSL certificate from Let's Encrypt. If you already have an SSL certificate, you can add it to the server.

  • The website's domain name has an AAAA record, but the IPv6 address isn't selected in the website settings

    This issue will only affect visitors accessing the Web using IPv6.

    You should enable IPv6 on your website or remove the AAAA record.

    To change the website settings, go to the website card in FASTPANEL and then to Settings > Basic. In the IP address dropdown list, check the addresses specified in domain's AAAA records.

404 error in browser when accessing control panel

If you encounter this error, check for the presence of the fastpanel2 package, which might have been removed by the OS package manager to resolve dependencies when installing other software.

For Debian/Ubuntu:

dpkg -l | grep fastpanel2

For CentOS/Alma/Rocky:

rpm -qa | grep fastpanel2

The output should include a package named fastpanel2.

If the package has indeed been removed, you can reinstall it:

For Debian/Ubuntu:

apt install fastpanel2

For CentOS/Alma/Rocky:

yum install fastpanel2

Please note that installing fastpanel2 will result in the removal of previously installed software that caused the issue.

Certificate issuance may fail if the domain for which the certificate is being issued is present in the /etc/hosts file in lines beginning with:

127.0.0.1
::1

To successfully issue the certificate, remove the domain from these lines in the /etc/hosts file.

"Unable to execute /path/to/php -f /path/to/file" error occurs when accessing global PHP settings

The error Unable to execute /path/to/php -f /path/to/file occurs when overriding certain PHP directives globally.

To resolve this issue, it is recommended to move these changes to the PHP settings of the website. The PHP settings of the website are accessible from the website's card.

ProFTPD error message: "warning: unable to determine IP address of '%hostname'"

The error warning: unable to determine IP address of '%hostname' occurs when starting the ProFTPD FTP server if the server's hostname cannot be resolved to an IP address.

To resolve this error, specify a valid hostname for the server. It is recommended to use a third-level domain, for example, www.example.com.

You can specify the hostname with the following command:

hostnamectl hostname YOUR_DOMAIN

where YOUR_DOMAIN is the desired hostname.

.htaccess site rules are not working

It's likely that the site's PHP handler is set to PHP-FPM, which ignores the contents of .htaccess files.

To make .htaccess files work, you'll need to select CGI, FastCGI, or Apache as the handler.

"Fatal error: Allowed memory size of X bytes exhausted (tried to allocate Y bytes)" error in the website logs

The error occurs due to scripts in PHP exceeding the memory consumption limit.

Typically, this is resolved by increasing the memory_limit parameter in the PHP settings of the website.

Additionally, this parameter's value can be overridden in .htaccess files or directly within the PHP scripts themselves.

PHP-FPM services are not starting

The PHP-FPM services in the Settings -> Services menu are in a Stopped state, and attempting to start them results in an error Unable to start the service.

PHP-FPM services are started automatically and can only be managed if a service with a specific PHP version is connected to a website. If the PHP-FPM service with a specific PHP version is not connected to any website, it cannot be started.

Changing upload limits for phpMyAdmin and the file manager in FASTPANEL

You can change the file upload limits in the menu Settings -> Main -> Other.
Enter your desired value in the Maximum file upload size (MB) field.

Other issues

If you did not find a solution to the issue with FASTPANEL in this article, please contact our support service. We will be happy to help you!