With this project, my goal was to make installing Minecraft servers, no matter if they are Vanilla, Forge, Spigot, Paper and Leaf, as easy and beginner-friendly as possible. After making some Tutorials on my YouTube Channel and providing a detailed Documentation for them, there were still questions and problems on how to install a Minecraft Server on a Linux-Server. Thats why I created this All-in-One solution for installing a Minecraft Server (Forge, Vanilla, Spigot, Paper & Leaf).
This project was started with a simple goal: to make installing and managing a Minecraft server as easy and beginner-friendly as possible. Your contribution directly supports the project's future by helping to cover:
- Continuous Development: Keeping the installer compatible with the latest versions of Minecraft, Java, and all supported server platforms.
- Infrastructure Costs: Paying for the servers needed for testing, version checks, API and other backend features.
If you find this tool useful, please consider showing your support. Every little bit helps and is greatly appreciated!
- Debian 10
- Debian 11
- Debian 12
- Ubuntu 18.04
- Ubuntu 20.04
- Ubuntu 22.04
- Ubuntu 24.04
- SSH-Connection to your server
- Root Access to server (Script need to be executed as root)
- Linux-based operating systems (only on Supported Distros)
- Git needs to be installed on the server --> Installation
- Graphical User Interface (GUI)
- Easy-to-Use (even for beginners!)
- Automatic installation of required programs/packages
- Automatic installation of Java Versions for different Minecraft Versions (Including Java 8, Java 16, Java 17 and Java 21)
- Creating Minecraft Server start-scripts (including a check if the correct Java Version is selcted)
- Adjustable RAM-Allocation when installing a Minecraft Server
- Installed Servers are stored in Sub-Folders, to install more than one instance
- Support for multiple Linux Distributions (Ubuntu & Debian)
- Supported Minecraft Vanilla Versions: Minecraft 1.7.X - 1.21.X
- Supported Minecraft Forge Versions: Minecraft 1.7.10 - 1.21.X
- Installing a specific Forge Version. (A Version Overview can be found here)
- Supported Minecraft Spigot Versions: 1.8.X - 1.21.X
- Using Spigot's offical BuildTools to compile the spigot.jar(s)
- Caching of already compiled spigot.jar(s) to avoid unneccessary re-compilation of already compiled spigot.jar(s)
- Supported Minecraft Paper Versions: 1.8.X - 1.21.X
- Possibility to install every existing build of Paper
- Show list of available builds for each version to select from
- Using Paper's official API to obtain available builds
- Adjusted Sub-Folder Naming (including the build-number)
- Supported Minecraft Leaf Versions: 1.19.2 - 1.21.X
- Possibility to install every existing build of Leaf
- Show list of available builds for each version to select from
- Automatic distinction between direct download versions and versions with build selection.
- Using Leaf's official API for versions that support build selection.
- Adjusted Sub-Folder Naming (including the build-Number)
- Important: The Leaf developers recommend using version 1.21.4 or newer. Older versions are not recommended for production use.
Prerequisites:
apt install git
Downloading the script:
git clone https://github.com/officialrealTM/mcserver_installer.git
Go into the downloaded folder:
cd mcserver_installer
Start the Script:
./mcserver_installer.sh
No. At least not yet. The Script has been developed and tested on --> Supported Distros. To disable the Distro check see: Experimental Settings
You Minecraft Server files will get stored in /Servers/Minecraft-<versionnumber>
When installing multiple servers of the same type (e.g. two Minecraft 1.8.9 Servers) the second folder will be called Minecraft-<versionnumber>-1
(or 2 and so on)
Yes. But here you need to keep a few things in mind:
- Your Linux server need to be powerfull enough
- You need to adjust the Port of the second/third/etc. Minecraft server (because Port 25565 is already in use.) This can be adjusted in the
server.properties
file
Yes. To do so go to your Server folder (cd /Servers/Minecraft-<versionnumber>
) and open the start.sh
file.
In the last line of this file you can adjust the number after -Xmx
to adjust more or less ram.
No. This script can only install full game versions. Snapshot Versions are not supported!
Dont worry, the console will kept open in the background using screen.
Use this command, to show all active screen sessions:screen -ls
If only one Sessions is active you can use this command, to open it: screen -rx
If multiple Sessions are active use this command: screen -rx <Name of screen session>
To close (detach) you Minecraft Console press [CTRL]+[A] and than [CTRL]+[D]
Feel free to ask me questions on my Discord.
You are very welcome to contribute to this project!
To do so, just create a Pull Request and describe your additions as accurate as possible!
Feel free to join my Discord to ask questions about the code's structure etc.
- Commenting & cleaning the sourcecode
These are all the packages used in this script:
Used Packages: dialog, sudo, wget, screen, jq, Python3, Python3-pip, Pip3-Packaging
Python Script: mcurlgrabber.py (Thanks to Christian!)
Important: With these experimental settings you can disable certain functions of the script. Use them at your own risk and only if you know what you are doing!
How to use:
All these commands must be executed in the homedirectory of the script, namely: /mcserver_installer
Disable Distro-check:
touch .skip_distro_check
Disable Script Version check:
touch .skip_version_check
Disable Installed-check:
touch .installed
Disable caching/archiving of compiled Spigot.jar(s):
touch .disable_spigot_archive
Enable Distro-check:
rm .skip_distro_check
Enable Script Version check:
rm .skip_version_check
Enable Installed-check (can also be used to re-check installed packages):
rm .installed
Enable caching/archiving of compiled Spigot.jar(s):
rm .disable_spigot_archive
For support, join my Discord and create a Ticket.
(Support in German and English)
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.
With this project, my goal was to make installing Minecraft servers, no matter if they are Vanilla, Forge, Spigot, Paper and Leaf, as easy and beginner-friendly as possible. After making some Tutorials on my YouTube Channel and providing a detailed Documentation for them, there were still questions and problems on how to install a Minecraft Server on a Linux-Server. Thats why I created this All-in-One solution for installing a Minecraft Server (Forge, Vanilla, Spigot & Paper).
- Debian 10
- Debian 11
- Debian 12
- Ubuntu 18.04
- Ubuntu 20.04
- Ubuntu 22.04
- Ubuntu 24.04
- SSH-Connection to your server
- Root Access to server (Script need to be executed as root)
- Linux-based operating systems (only on Supported Distros)
- Git needs to be installed on the server --> Installation
- Graphical User Interface (GUI)
- Easy-to-Use (even for beginners!)
- Automatic installation of required programs/packages
- Automatic installation of Java Versions for different Minecraft Versions (Including Java 8, Java 16, Java 17 and Java 21)
- Creating Minecraft Server start-scripts (including a check if the correct Java Version is selcted)
- Adjustable RAM-Allocation when installing a Minecraft Server
- Installed Servers are stored in Sub-Folders, to install more than one instance
- Support for multiple Linux Distributions (Ubuntu & Debian)
- Supported Minecraft Vanilla Versions: Minecraft 1.7.X - 1.21.X
- Supported Minecraft Forge Versions: Minecraft 1.7.10 - 1.21.X
- Installing a specific Forge Version. (A Version Overview can be found here)
- Supported Minecraft Spigot Versions: 1.8.X - 1.21.X
- Using Spigot's offical BuildTools to compile the spigot.jar(s)
- Caching of already compiled spigot.jar(s) to avoid unneccessary re-compilation of already compiled spigot.jar(s)
- Supported Minecraft Paper Versions: 1.8.X - 1.21.X
- Possibility to install every existing build of Paper
- Show list of available builds for each version to select from
- Using Paper's official API to obtain available builds
- Adjusted Sub-Folder Naming (including the build-number)
- Supported Minecraft Leaf Versions: 1.19.2 - 1.21.X
- Possibility to install every existing build of Leaf
- Show list of available builds for each version to select from
- Automatic distinction between direct download versions and versions with build selection.
- Using Leaf's official API for versions that support build selection.
- Adjusted Sub-Folder Naming (including the build-Number)
- Important: The Leaf developers recommend using version 1.21.4 or newer. Older versions are not recommended for production use.
Prerequisites:
apt install git
Downloading the script:
git clone https://github.com/officialrealTM/mcserver_installer.git
Go into the downloaded folder:
cd mcserver_installer
Start the Script:
./mcserver_installer.sh
No. At least not yet. The Script has been developed and tested on --> Supported Distros. To disable the Distro check see: Experimental Settings
You Minecraft Server files will get stored in /Servers/Minecraft-<versionnumber>
When installing multiple servers of the same type (e.g. two Minecraft 1.8.9 Servers) the second folder will be called Minecraft-<versionnumber>-1
(or 2 and so on)
Yes. But here you need to keep a few things in mind:
- Your Linux server need to be powerfull enough
- You need to adjust the Port of the second/third/etc. Minecraft server (because Port 25565 is already in use.) This can be adjusted in the
server.properties
file
Yes. To do so go to your Server folder (cd /Servers/Minecraft-<versionnumber>
) and open the start.sh
file.
In the last line of this file you can adjust the number after -Xmx
to adjust more or less ram.
No. This script can only install full game versions. Snapshot Versions are not supported!
Dont worry, the console will kept open in the background using screen.
Use this command, to show all active screen sessions:screen -ls
If only one Sessions is active you can use this command, to open it: screen -rx
If multiple Sessions are active use this command: screen -rx <Name of screen session>
To close (detach) you Minecraft Console press [CTRL]+[A] and than [CTRL]+[D]
Feel free to ask me questions on my Discord.
You are very welcome to contribute to this project!
To do so, just create a Pull Request and describe your additions as accurate as possible!
Feel free to join my Discord to ask questions about the code's structure etc.
- Commenting & cleaning the sourcecode
These are all the packages used in this script:
Used Packages: dialog, sudo, wget, screen, jq, Python3, Python3-pip, Pip3-Packaging
Python Script: mcurlgrabber.py (Thanks to Christian!)
Important: With these experimental settings you can disable certain functions of the script. Use them at your own risk and only if you know what you are doing!
How to use:
All these commands must be executed in the homedirectory of the script, namely: /mcserver_installer
Disable Distro-check:
touch .skip_distro_check
Disable Script Version check:
touch .skip_version_check
Disable Installed-check:
touch .installed
Disable caching/archiving of compiled Spigot.jar(s):
touch .disable_spigot_archive
Enable Distro-check:
rm .skip_distro_check
Enable Script Version check:
rm .skip_version_check
Enable Installed-check (can also be used to re-check installed packages):
rm .installed
Enable caching/archiving of compiled Spigot.jar(s):
rm .disable_spigot_archive
For support, join my Discord and create a Ticket.
(Support in German and English)
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.