Please read before posting!

Please read this full post, including the FAQ topics.

Before opening a new thread, please read these guidelines:
- If your system is malfunctioning, please run the test script and share the output in a code block.
How to run the test script
To start the test, run the following command as root user on your server:

Code:

wget -q -O htf-common-issues.php "http://gitplace.net/pixcept/ispconfig-tools/raw/stable/htf-common-issues.php" && php -q htf-common-issues.php

to view the report, run this command:

Code:

cat htf_report.txt | more

IP addresses are already anonymized in the report, so you can post it safely here in the forum.

- If you are sharing logs, the output of a command, or the content of config files, put it in a code block like this:

(Insert - Code -> paste the output)
- Write your normal text outside of the code block.
- Always share your OS and PHP CLI version.

Expand: How do I find these?

You can find your OS version with

Code:

lsb_release -a

and your PHP version with

Code:

php -v

- Share the related software you are using (for example, when you have a question related to your webserver, are you using Apache or NGINX?)
- Read this FAQ before posting:
1. I can't issue a Let's Encrypt cert (box is unchecked/error in log, etc)
Read the Let's Encrypt FAQ: https://www.howtoforge.com/community/threads/lets-encrypt-error-faq.74179/

2. When visiting domain B, the content of domain A is showing!
This problem can have 2 causes:
- You have HTTPS enabled for domain A but not for domain B, will visiting domain B over HTTPS. It is Apache's default behaviour to show the first website in the list that has HTTPS enabled.
- domain A is listening on * while domain B is listening on a specific IP, or vice versa. Make sure all your webs are listening on a specific IP or *.

3. I can't send mails with Roundcube - error 220/250 (SMTP auth failed)
In your Roundcube config (/etc/roundcube/config.inc.php), change Make sure the config for smtp_server is localhost, like this:

Code:

$config['smtp_server'] = 'localhost';

and the smtp_port setting is 25, like this:

Code:

$config['smtp_port'] = 25;

4. Something is not working after updating ISPConfig
Did you let the update script reconfigure your services? If not, run a forced update and let it reconfigure services with

Code:

ispconfig_update.sh --force

Make sure you don't have any out of date custom config templates in /usr/local/ispconfig/server/conf-custom - update them accordingly before reconfiguring the services.

5. ISPConfig is not writing changes to disk
It takes about 1 minute until ISPConfig writes changes to disk, ensure that you waited long enough before you test changes. If a job is listed in the jobqueue of the ispconfig monitor, then this job has not been processed yet. Wait until it disappears from the list.
Debug instructions for the ISPConfig server process are in the FAQ: https://www.faqforge.com/linux/debugging-ispconfig-3-server-actions-in-case-of-a-failure/

6. Panel not showing up / server.sh script error
Make sure you are using the default PHP version for your OS with

Code:

update-alternatives --config php

and

Code:

update-alternatives --config php-cgi

These are the default versions that should be used:
Debian 9: PHP 7.0
Debian 10: PHP 7.3
Debian 11: PHP 7.4
Debian 12: PHP 8.2
Ubuntu 16.04: PHP 7.0
Ubuntu 18.04: PHP 7.2
Ubuntu 20.04: PHP 7.4
Ubuntu 22.04: PHP 8.1
CentOS 7: PHP 5.4
CentOS 8: PHP 7.2

This issue can be caused by installing/updating a (new) PHP version.

7. I can't send/receive email
Are you able to send and receive emails with webmail? A easy test if the local mailsystem works is to login to webmail with a account hosted on the server and send a email to the same address that you used to login to webmail. The email shall arrive within a minute back to your account when the local mailsystem works. If the email does not arrive, post the error message(s) that you get in the mail log file when the problem occurs. The mail log file is in the folder /var/log/, it is named "mail.log" on Debian and Ubuntu Linux and named "maillog" on other distributions.

8. Problems with websites or PHP
- Which webserver software do you use, apache or nginx?
- Post the errors that you find in the global webserver error.log and the ones from the error.log of the website. The global log file is e.g. in /var/log/apache2/ for the apache server and the website error log is in /var/www/yourdomain.tld/log/

9. DNS related problems
- Have you waited long enough? Changes in DNS may take up to 24 hours until they propagate to all dns caches. If you like to test the local dns server for a domain name without waiting for the caches to renew, use this command:

Code:

dig @localhost yourdomain.tld

replace yourdomain.tld with the domain name that you want to query your local dns server for.
- If the nameservers (ns records) of the zone are subdomains of the zone, then ensure that you created A-Records for the ns1 and ns2 server in the zone as well and it might be nescessary to add glue records in the dns server of the domain registry.
- Post the errors of the named daemon (the BIND dns server logs under the name named) from /var/log/syslog




--- Post History ----------------------------------------------------
2013/11/28: Added ISPConfig test script.
2021/02/10: Big update to the post, which is now shown in General and Installation/Configuration.
2021/02/15: Added FAQ info for the correct PHP version of the OS.
2023/09/10: Added Debian 12 and Ubuntu 22.04 with their default PHP version.
2024/01/23: Removed all spoilers to show all FAQs instantly. Removed note about bug in ISPConfig 3.2.3 (fixed in 3.2.4).[/SPOILER]