Public | Automated Build

Last pushed: 2 years ago
Short Description
Sponge for Minecraft forge
Full Description

Docker Sponge

Docker sponge is a Minecraft server environment for Sponge / Forge servers.

  • Supports Sponge Vanilla and Sponge Forge

  • Not meant for production environments

Quick Setup

  1. Install Docker Toolbox

  2. Install Virtualbox

  3. Clone project:

     $ git clone  
     $ cd docker-sponge/
  4. Run the setup

    • Create both Sponge Forge and Sponge Vanilla:

        $ ./
    • Create only Sponge Forge:

        $ sponge-forge/
    • Create only Sponge Vanilla:

        $ sponge-vanilla/
  5. Browse and update your Mincraft server files in the following locations:

    • docker-sponge/sponge-forge/data

    • docker-sponge/sponge-vanilla/data

Customizing Quick Setup

  1. Edit the docker-compose.yml in the root of the project.

    • You can update the following settings:

      • Container Name

      • Port(s)

      • Sponge and Forge Versions

      • Memory

  2. You may add additional ports by adding to the ports: and expose: sections.

  3. If you already have a running container you can destroy it:

     $ docker stop forge  
     $ docker rm forge


     $ docker stop vanilla  
     $ docker rm vanilla
  4. Re-build your container:

    • Both containers (from docker-sponge/ directory):

        $ docker-compose up -d
    • Only Sponge Forge:

        $ cd docker-forge/  
        $ docker-compose up -d
    • Only Sponge Vanilla:

        $ cd docker-vanilla/  
        $ docker-compose up -d

Manual Setup

  1. Install Docker Toolbox

  2. Install Virtualbox

  3. Create a docker-machine and setup your environment:

     $ docker-machine create --driver virtualbox sponge  
     $ eval "$(docker-machine env sponge)"
  4. Create container(s):

    Sponge Forge

     $ docker run -itd -p 25566:25566 \
     -v /path/on/host:/forge \
     -e MINECRAFT_PORT=25566 \
     -e MINECRAFT_EULA=true \
     -e FORGE_VERSION=1.8.9- \
     -e SPONGE_VERSION=1.8.9-1890-4.2.0-BETA-1446 \
     --name forge mmonkey/sponge-forge

    Sponge Vanilla

     $ docker run -itd -p 25567:25567 \
     -v /path/on/host:/vanilla \
     -e MINECRAFT_PORT=25567 \
     -e MINECRAFT_EULA=true \
     -e SPONGE_VERSION=1.8.9-4.2.0-BETA-337 \
     --name vanilla mmonkey/sponge-vanilla
  • Minecraft server files will be placed in the path you specified on this line -v /path/on/host:/forge

    • On Windows, the host path should start from /c/Users/<path>

    • On Mac, the host path should start from /Users/<path>

  • You may add additional ports by adding -p XXXX:XXXX --expose XXXX (change XXXX to the desired port number)

Connecting to the server

Local Machine

  1. Obtain the server's ip address:

     $ docker-machine ip sponge
  2. Ports (default)

    • Forge:

    • Vanilla:


  1. Open Oracle VM VirtualBox Manager

  2. Select the VM used by Docker (sponge)

  3. Click Settings -> Network

  4. Make sure Adapter 1 is set to "NAT"

  5. Click Advanced -> Port Forwarding

  6. Add the rules that apply:

    • Name: Forge, Protocol: TCP, Host Port: 25566, Guest Port: 25566 (Leave Host IP and Guest IP empty)

    • Name: Vanilla, Protocol: TCP, Host Port: 25567, Guest Port: 25567 (Leave Host IP and Guest IP empty)

  7. Restart docker-machine:

     $ docker-machine stop sponge  
     $ docker-machine start sponge

Attaching to the running containers:


$ winpty docker attach forge  
$ winpty docker attach vanilla


$ docker attach forge  
$ docker attach vanilla

Detaching from the running containers:

Keystroke: [CTRL] + [p] then [CTRL] + [q]

NOTE: If you [CTRL] + [c] while attached to the running container, the container will be stopped.

Starting and stopping the server

$ docker stop forge  
$ docker start forge


$ docker stop vanilla  
$ docker start vanilla

Starting, stopping and restarting the virtual machine

  • You will need to start the docker machine if the Host computer restarts or powers off

  • You may want to stop the docker machine to preserve the Host computers resources

Starting docker machine

$ docker-machine start sponge

Stopping docker machine

$ docker-machine stop sponge

Restarting docker machine

$ docker-machine restart sponge


  • When trying to run docker commands in a new bash window: An error occurred trying to connect:

      $ eval "$(docker-machine env sponge)"
Docker Pull Command
Source Repository