Skip to content

Hosting a Paper Minecraft server


In this guide, you will be able to host a Paper 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 wget -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:

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 paper
cd paper

Installing Java

Run the commands below on the Minecraft user we created above.

curl -sL | bash && . ~/.jabba/
jabba install [email protected]
jabba alias default [email protected]


Run java to see if was installed correctly.


1.17+ should run this instead!

jabba install [email protected]
jabba alias default [email protected]

Getting the server jar

Please download one of the server Jars from below. Currently, 1.20.1 is the latest server jar. 1.20.1

wget -O server.jar


wget -O server.jar


wget -O server.jar


Don't see the version you are looking for? you can grab the server jar from this website or here

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 server.jar nogui

You will get a message asking you to accept the EULA. EULA

To accept the EULA just edit eula.txt and change false to true.

nano eula.txt

Before: EULA_file After: EULA_TRUE


To exit from nano use Ctrl + X and Y to save the edited text.

Next, you can run the same command again to start the server.

java -Xmx1024M -Xms1024M -jar server.jar nogui


server.jar might include numbering depending where you have downloaded your jar from, 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


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. MC_SERVER

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 Paper -L java -Xmx1024M -Xms1024M -jar 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 Paper and either issue commands or shutdown the server via CTRL+C.


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 /etc/systemd/system/.

nano /etc/systemd/system/[email protected]

Next, a screen like this will show up, you will fill it up with the config provided below. systemd_blank Use this config.

Description=Paper Minecraft server

ExecStart=/opt/minecraft/.jabba/jdk/[email protected]/bin/java -Xmx1024M -Xms1024M -jar server.jar nogui




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] 

Restart service:

systemctl restart [email protected] 

Status of service:

systemctl status [email protected] 

Stop service:

systemctl stop [email protected] 

View logs:

journalctl -n 50 -f -u [email protected]