Skip to content

Server Setup

Install Docker

We use Docker to create a consistent server environment for everyone. Follow Docker's install guide.

On Windows you can run winget install -e --id Docker.DockerDesktop to get it. Learn more about winget here. The Docker Desktop app is useful for starting/stopping your server and viewing logs, have a look through it later!

Create a docker compose file

  • Create a server directory wherever you like
  • Add a file named docker-compose.yml to it
  • Paste one of the following configurations into this file:
version: "3.9"
    container_name: papermc
      - "25565:25565"
      - "5005:5005"
      # Stores server files in a folder named papermc next to your compose.yml
      - ./papermc:/data
      # Optionally, clone the server-config repo to work with configs locally
      #- ./server-config:/server-config
        EULA: true # You're accepting the Minecraft EULA here!
        TYPE: PAPER
        VERSION: 1.19.4 # Change as needed
        EXEC_DIRECTLY: true
        USE_AIKAR_FLAGS: true
        # Enables live debugging
        JVM_OPTS: "-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005"
    # Allows 'docker attach' to work
    stdin_open: true
    tty: true


You may wish to turn certain features on or off for your server (ex. auto updating plugins.) We list all supported environment options for our containers here.

Auto download plugins

The dev image comes with Keepup, our tool for managing plugins. It will automatically download our latest plugin config file to keepup/mineinabyss.conf and merge it with keepup/local.conf. You can inherit plugins from mineinabyss in local.conf as follows:

Inherit plugins from specific server

local: ${mineinabyss.servers.survival}

Inherit multiple parts

local: ${mineinabyss.core} ${mineinabyss.plugins}

Add your own plugins, or inherit specific ones

local: ${mineinabyss.core} {
  some-plugin: "https://..."
  blocky: ${mineinabys.plugins.blocky}


Keepup will not install a plugin if a similar one already exist in your plugins folder. So if you build a plugin locally, your version will be used. Remember to delete the file if you want updates!

Running the server

In Terminal

Open a terminal in the directory of your docker-compose.yml and run:

docker-compose up -d && docker attach papermc

To start in the background and attach to the papermc server for commands.

Tip: Use an alias for convenience

Linux/MacOS terminals usually let you modify their startup commands, here's an example I use to start my server by calling papermc:

alias papermc="docker-compose -f /path/to/my/docker-compose.yml up -d && docker attach papermc"

In IntelliJ

IntelliJ has some visual features for running containers right from the IDE. This is for more advanced devs.

Documentation here: Intellij Docker Guide.