Operating System CentOS

How to Install the Froxlor Server Management Panel on Debian 13

Install the froxlor hosting panel on Debian 13 from the project's apt repository, run the web installer and configure the services with froxlor-cli.

This guide installs the froxlor server management panel from the project's own package repository and takes you through the web installer and the service configuration, so that you end up with a working panel for managing customers, domains, mail and FTP accounts. It targets Debian 13 (trixie), the distribution the froxlor project recommends, and notes what changes on Debian 12 and Ubuntu 24.04 LTS.

CentOS 7 reached end of life in June 2024. Froxlor configures the web, mail and FTP services of the host from templates written for specific distributions, and its documentation recommends Debian or Ubuntu, so a Debian server is the right base for a new installation rather than a RHEL-family system.

Requirements

  • A freshly installed Debian 13 server. Froxlor rewrites the configuration of the services it manages, so do not install it on a host that already serves websites or mail.
  • Root access. The commands below are run as root; open a root shell with sudo -i.
  • A fully qualified hostname for the panel, for example panel.example.com, with a DNS A record pointing to the server. This name is reserved for froxlor: customers cannot use it for their own sites or mail.

According to the froxlor documentation, the panel needs Apache or nginx, PHP 7.4 to 8.5 with the session, ctype, xml, filter, posix, mbstring, curl, gmp and json extensions, and MySQL or MariaDB. The package installs the web server and PHP for you.

Step 1: Add the froxlor repository

Install the helper packages, download the repository signing key and add the repository:

apt -y install apt-transport-https lsb-release ca-certificates curl gnupg
curl -sSLo /usr/share/keyrings/deb.froxlor.org-froxlor.gpg https://deb.froxlor.org/froxlor.gpg
sh -c 'echo "deb [signed-by=/usr/share/keyrings/deb.froxlor.org-froxlor.gpg] https://deb.froxlor.org/debian $(lsb_release -sc) main" > /etc/apt/sources.list.d/froxlor.list'

On Ubuntu, replace https://deb.froxlor.org/debian with https://deb.froxlor.org/ubuntu in the last command. The repository serves Debian 13, 12 and 11 and the Ubuntu LTS releases 24.04 and 22.04. Ubuntu 26.04 was not on the project's supported list at the time of writing; check the installation page before using it.

Step 2: Install froxlor and MariaDB

apt update && apt upgrade
apt install froxlor mariadb-server

The froxlor package pulls in the web server and PHP and places the panel in /var/www/html/froxlor.

Step 3: Create a privileged database user

The installer needs a database account that is allowed to create databases and users, because froxlor later creates a database for each customer who orders one. Open the MariaDB shell:

mariadb -u root

Create the account with a password of your own. Avoid spaces, quotes and # in it:

CREATE USER 'froxroot'@'localhost' IDENTIFIED BY 'CHANGE_THIS_PASSWORD';
GRANT ALL PRIVILEGES ON *.* TO 'froxroot'@'localhost' WITH GRANT OPTION;
FLUSH PRIVILEGES;
EXIT;

Do not create the unprivileged froxlor database user yourself. The installer creates it and fails if it already exists.

Step 4: Run the web installer

Restart the web server so that all PHP modules are loaded, then open the installer in a browser:

systemctl restart apache2
http://203.0.113.10/froxlor

The installer first checks the PHP requirements. It then asks for:

  • the database host and the privileged account from step 3, plus a name and password for the unprivileged database user and database it will create;
  • the name, e-mail address and password of the first froxlor administrator;
  • the server's hostname and IP address, the distribution and the web server in use.

The installer is reached over plain HTTP at this point, so use a password you can change afterwards or tunnel the connection through SSH, and enable TLS for the panel as soon as the setup is finished.

Step 5: Configure the services

Froxlor does not only store settings in its database; it writes the configuration of the web server, mail server, FTP server and cron job on the host. That step is done from the shell as root. The last installer page shows a ready-made command for this. You can also start the interactive variant yourself at any time:

cd /var/www/html/froxlor
bin/froxlor-cli froxlor:config-services --create

The command asks for your distribution and then for the web server, mail services, FTP service and system services to configure. Enter x to skip a category. The cron service is always configured because froxlor depends on it, and selecting logrotate is advisable. If you enabled PHP-FPM or FCGID in the panel settings, select the matching service too. Run bin/froxlor-cli froxlor:config-services --help to see the remaining options, such as --apply for a saved selection.

The same selection is available in the panel under Configuration, which generates the command for you to run as root.

Step 6: Log in and verify

Open http://panel.example.com/froxlor and log in with the administrator account from step 4. Then check that the cron job runs without errors, because it is what turns changes made in the panel into configuration files:

cd /var/www/html/froxlor
bin/froxlor-cli froxlor:cron --force --debug

--force regenerates the configuration files and --debug prints what the job does. From here, create a customer, add a domain to it and confirm that the web server answers for that domain.

Open the firewall for the services you configured. With UFW, for web traffic:

ufw allow 80/tcp
ufw allow 443/tcp

Maintenance

Because froxlor was installed from a package repository, updates arrive with normal system updates:

apt update && apt upgrade

After a panel update, log in as administrator once; froxlor asks you to confirm database updates when a new version needs them. The command line offers the same through bin/froxlor-cli froxlor:update, and bin/froxlor-cli froxlor:update --check-only only reports whether a newer version exists.

Two more commands are worth knowing: bin/froxlor-cli froxlor:user --unlock admin unlocks an account after too many failed logins, and bin/froxlor-cli froxlor:user --change-passwd admin sets a new password.

Frequently asked questions

Can I install froxlor on AlmaLinux or Rocky Linux instead?

The panel itself is a PHP application and there is a tarball installation method, but the service configuration relies on templates for the distribution you select, and the project recommends Debian or Ubuntu. On a RHEL-family system you should expect to adapt the service configuration by hand.

Changes I make in the panel do not show up on the server. Why?

Changes are applied by the froxlor cron job, not at the moment you click save. Wait for the next run or trigger it with bin/froxlor-cli froxlor:cron --force. If nothing happens at all, the cron service was probably never configured; repeat step 5.

Why does froxlor need a database account with full privileges?

It creates and deletes databases and database users for customers. The panel's own data is accessed through the separate unprivileged account that the installer creates.

Can I use nginx instead of Apache?

Yes. Froxlor supports both. Choose the web server in the installer and in the panel settings, then run the service configuration again so the matching templates are written.

Share story:

Continue reading other guides on How VPS.