Installing Multicraft on Debian 9 ("Stretch")


I'm a pretty big advocate of Debian, but when I suggested to a friend
that he should host his Minecraft server on Debian, I soon saw that
there are no up-to-date guides to installing Multicraft, a popular
Minecraft server panel, on Debian. The most popular seems to be on the
Linode documentation, but it was even before Debian switched to systemd.

So, here's an up-to-date guide for installing and running Multicraft on
Debian 9, a.k.a. Stretch.

Before You Begin

Before starting this guide, you will need to have the following:

  1. Debian 9, installed and fully updated

    For reference, the following commands will get your Debian
    installation up-to-date:

    sudo apt update
    sudo apt dist-upgrade
  2. A non-root user with sudo permission

  3. An SSH server set up

It is assumed you are running any commands mentioned from a non-root
user over an SSH connection. If you run them as root, there's no telling what
will be the outcome.

Installing Prerequisites

Multicraft requires a webserver, PHP, SQLite (or MySQL, which will not
be covered here), and Java. Thankfully, these are all available in the
Debian repositories, so we can download them with a single command.

sudo apt install nginx sqlite php7.0-fpm php7.0-sqlite openjdk-8-jre-headless zip

This command installs nginx (a high-performance web server), sqlite
(the database software used by Multicraft), php7.0-fpm (the programming
language environment used by Multicraft, in a form suitable for Nginx),
php7.0-sqlite (an adapter to connect PHP with SQLite),
openjdk-8-jre-headless (an open-source version of Java 8, which is required
to run Minecraft servers), and zip (a utility for extracting zip files).

You might also need to install the wget and/or nano package(s) if they
aren't installed already.

Configuring the Web Server

Currently we have installed Nginx and PHP, but they aren't talking. To
make PHP work, we need to edit the Nginx configuration and enable it. To
edit the configuration file, open it with the following command (or
using your favorite editor; Neovim is my personal favorite):

sudo nano /etc/nginx/sites-enabled/default

In the first "server" block, change the "index" line to look like the

index index.php index.html index.htm index.nginx-debian.html;

Then, delete a single octothorpe ("#") from each of the following lines,
except the second to last:

location ~ \.php$ {
       include snippets/fastcgi-php.conf;

       # With php-fpm (or other unix sockets):
       fastcgi_pass unix:/var/run/php/php7.0-fpm.sock;
       # With php-cgi (or other tcp sockets):
       #       fastcgi_pass;

Last, after the location / block, add the following block to prevent
the protected directory from being accessed:

location /multicraft/protected {
        deny all;

Exit your editor (Ctrl+X, then Y, then enter with nano), then run the
following to reload the Nginx config file:

sudo systemctl reload nginx

Now that PHP is set up, it's time to install Multicraft.

Installing Multicraft

This bit is mostly from the Multicraft
, with
some minor changes.

First off, you will have to download Multicraft. It's easily wgettable:

wget -O multicraft.tar.gz

Then you need to extract it and change into the multicraft directory:

tar -xvf multicraft.tar.gz
cd multicraft

There's a nice shell script that will automatically install Multicraft
for you, so let's run it.

sudo ./

I'm going to give you a few recommended answers to the setup:

  1. "Run each Minecraft server under its own user?": Y
  2. "Run Multicraft under this user:": minecraft
  3. "User not found. Create user on start of installation?": Y
  4. "Install Multicraft in:": Press enter for the default
  5. "Will the web panel run on this machine?": Y
  6. "User of the webserver:": www-data
  7. "Location of the web panel files:": /var/www/html/multicraft
  8. "Enable builtin FTP server?": N
  9. "What kind of database do you want to use?": sqlite

Once that setup is done, you should be able to navigate to
http://[server ip here]/multicraft and set up the frontend.

Starting the Daemon

The typical way to start Multicraft is to use a command whenever you
turn on your server. Debian has a program called systemd which, when
configured properly, lets you automatically start Multicraft when the
system boots. I've already written a configuration file for you, so you
can download it straight to the configuration folder:

wget -O- | sudo tee /etc/systemd/system/multicraft.service

Once you've done that, run these commands to load the new configuration
file in, start Multicraft, and configure systemd to start it on boot:

sudo systemctl daemon-reload
sudo systemctl start multicraft
sudo systemctl enable multicraft

Now go back to your web browser and fully complete your front-end setup.

Finishing Touches

Finally, to complete your installation, delete your install.php file.

WARNING: Make sure you have completed the front-end setup first!

sudo rm /var/www/html/multicraft/install.php

Congratulations! You now have Multicraft installed on Debian 9.

Piper McCorkle

Piper McCorkle

Software engineer at Ladder, free software enthusiast, and overall computer nerd