Docs

A service will not start (Apache, MariaDB, PHP-FPM, Exim)

Read why a service failed with systemctl and journalctl, check the configuration, free disk space and memory, and bring Apache, MariaDB, PHP-FPM or mail back up.

AlmaLinux, Rocky Linux, Ubuntu, Debian 1 min read Updated

Server Monitoring restarts services that fail and emails the alert contacts. When a service keeps failing, find out why before restarting it again.

1. Ask systemd why#

systemctl status httpd --no-pager
journalctl -u httpd -n 80 --no-pager

Use the service's name. Most are the same on every system: mariadb, dovecot, named, pure-ftpd, lfd, intopaneld, intopanel-web. These differ:

ServiceAlmaLinux, Rocky LinuxUbuntu, Debian
Apachehttpdapache2
PHP-FPM (one per PHP version)php83-php-fpmphp8.3-fpm
Eximeximexim4
SSHsshdssh
Scheduled taskscrondcron

The examples below use httpd; on Ubuntu and Debian type apache2.

2. Check disk space and memory#

A full disk or a full /tmp stops almost every service:

df -h / /home /tmp /var
df -i /
free -m

If /tmp is full, find what filled it (du -xsh /tmp/* | sort -h | tail). If memory ran out, journalctl -k | grep -i "out of memory" shows which process the kernel stopped.

3. Check the configuration#

apachectl configtest            # Apache
exim -bV >/dev/null && echo ok  # Exim (exim4 on Ubuntu and Debian)
named-checkconf                 # BIND

A configuration change made by hand is the most common cause; undo it and start the service again.

4. Start it again#

systemctl restart httpd

Or use Service Status in the admin area, which shows every watched service with a restart button.

The panel itself#

If the panel's pages do not open, check its two parts:

systemctl status intopanel-web intopaneld --no-pager
journalctl -u intopaneld -n 100 --no-pager

Websites, mail and databases keep running while the panel is down; only the management pages are affected.

Frequently asked questions

MariaDB will not start after I changed my.cnf. What now?

Run journalctl -u mariadb -n 50 to see the line it refuses, undo that line in your own file in /etc/my.cnf.d/, and start it again. Settings made on the panel's Database Server Settings page are rolled back automatically when MariaDB does not start.

Where are the panel's logs?

journalctl -u intopaneld and journalctl -u intopanel-web, plus task logs under /var/log/intopanel/.

Was this article helpful?

Something missing? Ask in the community or open a ticket.