Skip to main content

Startup Configuration

Configure your server’s startup parameters and environment variables.

Accessing Startup Settings

  1. Select your server from the dashboard
  2. Click Startup in the left sidebar

Startup Variables

These are configuration options that affect how your server starts.

Common Variables

Different games have different variables. Here are some common ones:

Minecraft

VariableDescriptionExample
Server JARWhich server software to runserver.jar
Minecraft VersionGame version1.20.4
Server TypePaper, Spigot, Forge, etc.paper
Build NumberSpecific buildlatest

Vintage Story

VariableDescriptionExample
Game VersionVintage Story version1.19.0
Max PlayersPlayer limit16

Modifying Variables

  1. Find the variable you want to change
  2. Enter the new value
  3. Click Save or Update
  4. Restart your server for changes to take effect
Some variables require a server reinstall to take effect. Read the variable description carefully.

Startup Command

The startup command shows exactly what runs when your server starts:
java -Xms128M -Xmx{{SERVER_MEMORY}}M -jar {{SERVER_JAR}}
Variables in {{BRACKETS}} are replaced with actual values.

Docker Image

Your server runs in a Docker container with a specific image:
GameTypical Image
Minecraft (Java)Java 17
Minecraft (Older)Java 8
Vintage StoryCustom VS image
The Docker image determines available Java versions and system dependencies. Contact support if you need a different image.

Java Version

For Minecraft, different versions require different Java:
Minecraft VersionJava Required
1.20.5+Java 21
1.17 - 1.20.4Java 17
1.12 - 1.16.5Java 8 or 11
Below 1.12Java 8

Changing Server Software

Minecraft Example

To switch from Vanilla to Paper:
  1. Go to Startup settings
  2. Change Server Type to paper
  3. Set your desired Minecraft Version
  4. Save and reinstall if prompted
Switching server software may require reinstalling and could affect world compatibility. Always backup first!

Memory Allocation

The {{SERVER_MEMORY}} variable is set based on your plan. This determines:
  • Maximum RAM your server can use
  • Java heap size (-Xmx)

Troubleshooting

Server Won’t Start After Changes

  1. Check console for error messages
  2. Verify variable values are valid
  3. Try resetting to default values
  4. Contact support for assistance

Wrong Java Version

  • Check the Docker image being used
  • Contact support to change the image
  • Verify your Minecraft version requirements

Mod/Plugin Compatibility

  • Ensure server type supports your mods/plugins
  • Verify version compatibility
  • Check mod requirements in their documentation

Next Steps