Introduction and Automatic Setup
Do you want to run a server for Create: Astral without the hassle of setting up Java and Fabric?
This repository allow you to run a server for the Create: Astral Minecraft® modpack using a container engine like podman
or docker
.
Everything is bundled, just do some configuration and you're set.
To set up:
- Clone this repository
- Accept the Minecraft EULA by changing
EULA: "FALSE"
toEULA: "TRUE"
in compose.yml - Choose a secure password for RCON. (RCON is not exposed to the network by default)
- Run
podman-compose up -d
The server should now be up and running.
Run
podman exec -itl rcon
to get access to the RCON interface to the last server you started where you can run admin commands. (RCON_PASSWORD
must be set for this.)
This image is still quite new and features might still be added (or worse, removed) from it.
Configuration
server.properties
The container generates server.properties from your configuration as well as some defaults when started. To configure the server
- Enter only the desired configuration options into
server.properties
, for example:
# Example configuration, see https://server.properties or Minecraft Wiki for available options.
gamemode=creative
enable-command-block=true
Note that configuration changes you make overwrite configuration changes made by the image.
For example, if you include rcon.password
in your server.properties instead of using the
environment variable, the RCON command above will fail due to the password not being equal
to the environment variable.
ops.json, banned-players.json, banned-ips.json
These files are mounted as-is into the image. This means that this data is stored in the folder where you run your compose command. The required templates for these files are included.
If you want to modify other files like those in the config
folder, consider adding the
/data/config
folder as a volume similar to how the files above are set up.
Manual Setup
The server can be set up without using a layer like podman-compose
or docker-compose
.
Simply run (The commands should be mostly equivalent for docker
)
podman volume create astral-world
podman volume create astral-backup
podman run -d -e EULA=TRUE \
-e RCON_PASSWORD=hunter2 \
-p 25565:25565 \
-v ./ops.json:/data/ops.json:z \
-v ./banned-players.json:/data/banned-players.json:z \
-v ./banned-ips.json:/data/banned-ips.json:z \
-v astral-world:/data/world:z \
-v astral-backup:/data/backup:z \
ghcr.io/maxi0604/create-astral:v2.0.5b
to get started. This will run a Create: Astral server on port 25565 (the default) which stores the game world in a named volume.
License
I do not claim ownership of or affiliation with Minecraft®, Create: Astral or FabricMC.
This software package does not redistribute the Minecraft® server by itself, the server software is downloaded
when the container is initialized. The Create: Astral modpack is redistributed with preliminary permission from a developer.
To use this software you must agree to the Minecraft EULA by setting the environment variable EULA=true
.
The files in this repository, where legally permissible, are licensed to you under the MIT license.