Hosting a Nukkit Server¶
In this guide, you will be able to host a Nukkit Minecraft server as well as keeping it alive without having to be logged in all the time. Before you start, make sure you meet the requirements and have a basic understanding of Linux, if you have issues or are stuck on a step you can ask for help in our support server.
- You have a Linux VPS (Debian/Ubuntu).
- You are logged in as root or have a user that can use sudo.
- You know how to establish an SSH connection or use an SSH client.
Don't know how to connect to your server? Check out this guide.
Installing required packages¶
I recommend that you should be logged in as root before executing these commands to ensure everything goes smoothly.
apt update && apt upgrade -y apt install sudo screen unzip curl -y
You may get a popup like the one below, use the arrow key to click yes to proceed.
Creating a user for Minecraft¶
For security purposes, Minecraft should not be running under the root user. We will create a new system user and group with home directory /opt/minecraft that will run the Minecraft server and install unzip which is needed later.
sudo useradd -r -m -U -d /opt/minecraft -s /bin/bash minecraft
We are not going to set a password for this user. This is a good security practice because this user will not be able to log in via SSH. To login to the Minecraft user, you’ll need to be logged in to the server as root or user with sudo privileges.
Before starting with the installation process, make sure you switch to the Minecraft user.
sudo su - minecraft
Creating the Directory¶
If you plan to have multiple versions of Minecraft running I would recommend creating a folder for them to make sure the files do not conflict.
mkdir nukkit cd nukkit
Run the commands below on the Minecraft user we created above.
curl -sL https://github.com/shyiko/jabba/raw/master/install.sh | bash && . ~/.jabba/jabba.sh jabba install [email protected] jabba alias default [email protected]
java to see if was installed correctly.
Getting the server jar¶
Please download the server jar from below.
wget https://ci.opencollab.dev/job/NukkitX/job/Nukkit/job/master/lastSuccessfulBuild/artifact/target/nukkit-1.0-SNAPSHOT.jar -O Nukkit-server.jar
Don't see the version you are looking for? you can grab the server jar from this website
Running the server¶
First, make sure you do have java installed by running
java and make sure you have the server jar file by running
ls and you should see
server.jar or the file you downloaded, to run the server run the command below once.
java -Xmx1024M -Xms1024M -jar Nukkit-server.jar nogui
You will be asked to choose a language when you first run the server, you can also increase the ram used by upping the Xmx and Xms flags.
Connecting to the server¶
You should grab the IP of your server which can be found using the command below if you do not know it.
dig +short myip.opendns.com @resolver1.opendns.com
If the command above fails, try this command and copy the output as that is the IP of your server.
Copy the IP and open Minecraft up, go to servers and click add a server and under
Server Address put the server's IP in and click Done.
Keeping your server alive¶
Screen is one way of keeping your server running in the background without having to keep your SSH session open.
screen does not boot on load or write logs to the disk automatically, reboots would kill the screen due to only being a virtual session.
To start your server with screen, first, make sure you have
screen package installed.
You should've installed screen from the start of the guide. In the eventuality that you do not have
screen package installed, please use the command below and make sure you're using root or sudo. You can install screen using the one-liner below:
sudo apt update && sudo apt install screen -y
Make sure you are using root if you are still on the Minecraft account use
exit, then execute the commands after you are done you should use the command listed to switch back to the Minecraft account
sudo su - minecraft.
You can then start your server by using the command below:
screen -S Nukkit -L java -Xmx1024M -Xms1024M -jar Nukkit-server.jar nogui
This should create a session you can safely leave without fear of it shutting down when you leave,
You can leave the screen via
CTRL+AD from this session so your Server is still online when you leave.
You can re-attach to the running screen by running
screen -r Nukkit and either issue commands or shutdown the server via
Systemd can be an easy way of keeping your Minecraft server up, setting a service file for Minecraft should be easy and quick if you follow closely, first you should switch to root for this by running the command below.
Once you are root we will start by creating a service file called
[email protected] in
nano /etc/systemd/system/[email protected]it.service
Next, a screen like this will show up, you will fill it up with the config provided below. Use this config.
[Unit] Description=Nukkit Minecraft server After=network.target Wants=network-online.target [Service] Type=simple User=minecraft WorkingDirectory=/opt/minecraft/nukkit/ ExecStart=/opt/minecraft/.jabba/jdk/[email protected]/bin/java -Xmx1024M -Xms1024M -jar Nukkit-server.jar nogui Restart=always RestartSec=10 [Install] WantedBy=multi-user.target
To exit out of nano, use Ctrl + X and hit Y
Run the commands below to test and start the server
systemctl daemon-reload systemctl start [email protected] systemctl status [email protected] systemctl enable [email protected]
Here are some commands that will help you effectively manage the service. Start service:
systemctl start [email protected]
systemctl restart [email protected]
Status of service:
systemctl status [email protected]
systemctl stop [email protected]
journalctl -n 50 -f -u [email protected]