Momo edited this page Dec 17, 2017 · 26 revisions

Glowstone Installation

Installing Glowstone is as easy as installing any other server software.

Install Java

Install Oracle Java 8 (recommended). If you're running a Linux distro, look into installing Oracle Java through your package manager before using these downloads. But, if you really don't want Oracle Java, you can use OpenJDK. Note: We require Java 8 update 101 or greater. Our Maven repository uses a Let's Encrypt HTTPS certificate, and Let's Encrypt was added to the Java truststore in update 101. Without this truststore, our library manager fails to pull dependencies from our server, due to an SSL security error.

Confirm that you have Java 8 by running java -version in your system's command prompt/terminal. You should see something like java version "1.8.0_121" at the top. As long as it includes 1.8, and the number after the _ is more than 101, you're good.

If you installed Java 8 on macOS, but java -version is showing an older version, run

sudo mv /usr/bin/java /usr/bin/java-1.6
sudo ln -s '/Library/Internet Plug-Ins/JavaAppletPlugin.plugin/Contents/Home/bin/java' /usr/bin/java

For more details, see this guide.

Install Glowstone

  1. Download the latest build of Glowstone.
  2. Move the jar file to your server folder. If you drop and run the jar in your current server folder, it will automatically migrate most settings to Glowstone.


Using a text editor like Notepad, create a new start script named start.bat to launch the jar file:

@echo off  
java -Xms768M -XX:+UseG1GC -jar glowstone.jar

Make sure you select All Files as the file type in the save window.

Finally, double click the start.bat file.


Using a text editor like gedit, mousepad, Atom, Sublime Text, nano, (Neo)vi(m), Kate or emacs, create a new start script named to launch the jar file:

BINDIR=$(dirname "$(readlink -fn "$0")")  
cd "$BINDIR"  
java -Xms768M -XX:+UseG1GC -jar glowstone.jar

Open terminal, go to your Glowstone folder and enter this command to give the script execute permissions:

chmod +x

Enter this command in the terminal to start the server:



Using a text editor like TextEdit, create a new start script named start.command to launch the jar file:

cd '$( dirname "$0" )'
java -Xms768M -XX:+UseG1GC -jar glowstone.jar

Open terminal, change current directory by typing cd and dragging and dropping the Glowstone folder into terminal window.

At this point it should look like this:

cd /Users/YourName/YourGlowstoneFolder/Glowstone  

If you think that is correct press enter and move to the next step.

Just type (do not enter!) this command to give the script execute permissions:

chmod a+x

Drag start.command into the Terminal window. Confirm there is a space between chmod a+x and the start.command path, and then enter. Finally, double click the start.command file to start the server.

After thoughts

If you have any trouble setting up, we would be happy to help you on the forums, Discord, or IRC (#glowstone on esper). Otherwise, congratulations! You've just installed Glowstone!

  • If you can't access your server from your public IP, make sure you have port forwarded or used a UPnP port mapper to allow incoming connections to your server.
  • For server issues or suggestions, create an issue on Github.
  • By default, all configuration files are in the config folder.


Most Bukkit, Spigot and Paper plugins will work on Glowstone. Only plugins that use Paper-Server, Spigot-Server, CraftBukkit or Minecraft code will not work, unless they are designed to fail gracefully. Read more.

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.