From time to time, the EMSM receives some updates. Especially the server database and the server download urls. So how can you update the EMSM?

Server updates


Some servers need to be built or don’t work out the box, which may cause problems with the privilege downgrade of EMSM. In those cases you can either replace the server jars in the server directory manually or you may try to execute the update command directly as minecraft user:

$ su -i --shell=/bin/bash minecraft
$ minecraft -s "spigot latest" server --update
seealso:issue 68

The server software is usually updated faster than the EMSM database. But don’t worry, you can often use the latest server software with the EMSM.

Let’s assume, the minecraft server 1.8 received a patch from mojang and you want to use it:

  1. Edit the server.conf configuration file:
[vanilla 1.8]
# Setting the url here, will overwrite the value in the EMSM database.
url = https://s3.amazonaws.com/Minecraft.Download/versions/1.8.1/minecraft_server.1.8.1.jar
  1. Update the server with the server plugin:

    $ minecraft -s "vanilla 1.8" server --update

If the update fails, the old server software will be restored and nothing changed.

Please take a look at the server configuration and the server plugin for more information.

EMSM updates

The EMSM is a Python package and you can simply update it using pip:

$ pip3 install --upgrade emsm

Since the instance folder is not touched by this command, there is no need for a backup before an update anymore.

If the EMSM does not work as expected after the update, take a look at the Changelog or create an issue.


If the major version number changes, you should take a look at the Changelog first. There will be an upgrade guide and additional information.