Operating System CentOS

How to Install Multicraft (Minecraft Panel) on AlmaLinux 9 or Rocky Linux 9

Set up the Multicraft Minecraft panel on AlmaLinux 9 or Rocky Linux 9 following the official installation guide, including SELinux and firewall settings.

Multicraft is a commercial web control panel for Minecraft servers. It consists of a PHP front end, where you and your users create, start, stop and configure servers, and a daemon that actually runs the Minecraft processes. This guide installs Multicraft 2.5.0, the version currently offered on the vendor's download page, on AlmaLinux 9 or Rocky Linux 9 with Apache, PHP and MariaDB, with the panel and the daemon on the same machine.

CentOS 6 reached end of life in November 2020 and no longer receives packages or security fixes; AlmaLinux 9 and Rocky Linux 9 are its compatible successors. Service management, PHP, SELinux handling and the firewall all work differently there, so the procedure below follows the current Multicraft installation documentation rather than the old chkconfig-era steps.

Licensing

Multicraft is proprietary software. Downloading it means accepting the Multicraft End User License Agreement. The vendor's pricing page lists a Free edition for personal use, limited to one machine per panel, and a paid Dynamic subscription for hosting providers. Without a licence key the installer sets up the free edition. Minecraft itself is covered by Mojang's own EULA, which you must accept before a server will start.

Requirements

  • An AlmaLinux 9 or Rocky Linux 9 server with root access. Run the commands as root or with sudo; the Multicraft setup script and the daemon must be started as root.
  • Enough memory for the Minecraft servers you plan to run, on top of the operating system and database.
  • For the panel, Multicraft requires a web server with PHP (5.4 or later, including PHP 8) and the PHP extensions pdo_mysql, pdo_sqlite, curl, xml, gd and ftp. The daemon has no external requirements; Minecraft needs Java.

Step 1: Install Apache, PHP, MariaDB and Java

sudo dnf install httpd php php-pdo php-mysqlnd php-gd php-xml php-mbstring \
  mariadb-server java-21-openjdk-headless wget tar zip unzip

Check that the required extensions are present:

php -m | grep -E -i 'pdo_mysql|pdo_sqlite|curl|xml|gd|ftp'

Recent Minecraft releases need a recent Java runtime. Check the requirement of the Minecraft version you intend to run and install a newer java-*-openjdk-headless package if necessary.

Start the services and enable them at boot. On this distribution family Apache runs PHP through PHP-FPM:

sudo systemctl enable --now httpd php-fpm mariadb

Step 2: Create the databases

Multicraft's security recommendations call for separate panel and daemon databases. Secure MariaDB and open the client:

sudo mariadb-secure-installation
sudo mariadb
CREATE DATABASE multicraft_panel;
CREATE DATABASE multicraft_daemon;
CREATE USER 'multicraft'@'localhost' IDENTIFIED BY 'choose-a-strong-password';
GRANT ALL PRIVILEGES ON multicraft_panel.* TO 'multicraft'@'localhost';
GRANT ALL PRIVILEGES ON multicraft_daemon.* TO 'multicraft'@'localhost';
FLUSH PRIVILEGES;
EXIT;

Step 3: Allow .htaccess in the panel directory

The panel protects its protected directory with an .htaccess file, which Apache honours only when AllowOverride All is set. Add it for the directory the panel will live in:

sudo tee /etc/httpd/conf.d/multicraft.conf > /dev/null <<'EOF'
<Directory "/var/www/html/multicraft">
    Options -Indexes +FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>
EOF
sudo systemctl reload httpd

Step 4: Download Multicraft and run setup.sh

Download the Linux package from the vendor, unpack it and start the setup script as root:

sudo -i
cd /root
wget "https://www.multicraft.org/download/linux64?version=2.5.0" -O multicraft.tar.gz
tar xvzf multicraft.tar.gz
cd multicraft
./setup.sh

The script asks a series of questions and changes nothing until you confirm at the end. Use these answers for a single-machine installation:

QuestionAnswer
User that runs the serversminecraft (the default; the script creates it)
Multicraft base directory/home/minecraft/multicraft (the default)
Licence keyyour key, or leave empty for the free edition
Web server userapache
Location for the panel files/var/www/html/multicraft
DatabaseMySQL, with the daemon database, user and password from Step 2

According to the vendor's documentation, setup.sh then creates the user, copies the bin and jar directories to the base directory, writes multicraft.conf from your answers, copies the panel directory to the web root and sets ownership and permissions. Every setting is explained in multicraft.conf.dist inside the archive.

Step 5: Adjust SELinux

SELinux is enforcing by default and blocks the panel from reaching the daemon and the database. The Multicraft troubleshooting guide gives the two switches to set:

setsebool -P httpd_can_network_connect 1
setsebool -P httpd_can_network_connect_db 1

The panel also writes to a few of its own directories. If the web installer in the next step reports a directory as not writable, or the panel answers with error 500, label that directory as writable web content, for example:

chcon -R -t httpd_sys_rw_content_t /var/www/html/multicraft/protected/runtime

Use MySQL rather than SQLite on SELinux systems, as the vendor advises.

Step 6: Start the daemon and enable it at boot

Start the daemon as root; it drops its privileges after start-up:

/home/minecraft/multicraft/bin/multicraft start

Install the systemd unit that the vendor publishes so the daemon starts with the system:

wget https://www.multicraft.org/files/multicraft.service -O /etc/systemd/system/multicraft.service
chmod 644 /etc/systemd/system/multicraft.service
systemctl enable multicraft

The daemon log is /home/minecraft/multicraft/multicraft.log. To see start-up problems directly, run /home/minecraft/multicraft/bin/multicraft -nv start in the foreground.

Step 7: Finish in the browser

Open http://203.0.113.10/multicraft/ (your server's address). The front-end installer starts automatically. Walk through it with the same database settings you gave setup.sh: the panel database is multicraft_panel, the daemon database multicraft_daemon.

When it finishes:

  1. Log in with user admin and password admin, open Users and change the password immediately.
  2. Delete the installer and the unpacked archive:
    rm /var/www/html/multicraft/install.php
    rm -r /root/multicraft /root/multicraft.tar.gz
  3. Go to Settings → Update Minecraft, download and install the current server version.
  4. Create your first server under Servers → Create Server.

Step 8: Open the firewall

Allow web traffic and the default Minecraft port. Each additional Minecraft server needs its own port:

firewall-cmd --permanent --add-service=http --add-service=https
firewall-cmd --permanent --add-port=25565/tcp
firewall-cmd --reload

If your users should reach the built-in FTP server, also open the FTP port and the passive port range configured in multicraft.conf. With panel and daemon on one machine the daemon port does not need to be reachable from outside.

Verify and secure the installation

  • Settings → Multicraft Status must show the daemon as connected. If it reports that it cannot connect, check that the daemon is running and that the IP and port match multicraft.conf.
  • Request http://203.0.113.10/multicraft/protected/data/panel/schema.mysql.sql. You must get an error, not the SQL file. If the file is shown, AllowOverride All from Step 3 is not in effect.
  • Put the panel behind HTTPS before you give anyone else a login, and consider restricting superuser logins to your own IP addresses under Settings → Panel Configuration.
  • Back up both databases and /home/minecraft/multicraft/servers regularly, to a location the server cannot reach by itself.

The vendor's references are the installation guide and the security recommendations.

Frequently asked questions

Is Multicraft free?

There is a free edition for personal use that is limited to one machine per panel. Commercial hosting requires the paid Dynamic or Enterprise licence. Check the vendor's pricing page for the current terms, as they are set by the vendor and can change.

Can the panel and the daemon run on different servers?

Yes. That is how hosting providers use it: one panel controls daemons on several machines. Each daemon then needs network access to its database, and the daemon's allowedIps setting should restrict connections to your panel. More than one machine per panel requires a paid licence.

Why does a new server stop immediately after starting?

Look at the server console in the panel. The two usual causes are a Java runtime that is too old for the chosen Minecraft version and the Minecraft EULA not having been accepted for that server. "[Error 2]" in the console means Java is missing or not accessible to the minecraft user.

Does Multicraft work with Nginx?

Yes. Because Nginx ignores .htaccess, the vendor's security page tells you to add a location /protected block that denies all access.

Share story:

Continue reading other guides on How VPS.