java -xmx1024m -xms1024m -jar minecraft

This specific command “java -xmx1024m -xms1024m -jar minecraft_server.1.21.5.jar nogui” is a set of instructions used to launch a specific version of the official Minecraft server software from a command-line interface (like Terminal on macOS or Command Prompt on Windows).

java -xmx1024m -xms1024m -jar minecraft_server.1.21.5.jar nogui Command Breakdown

Here is what each part of the command java -Xmx1024m -Xms1024m -jar minecraft_server.1.21.5.jar nogui means:

java: This is the primary command that tells your computer to run the Java Virtual Machine (JVM), which is required to execute any Java program. Minecraft is built on Java.
-Xmx1024m: This is a JVM argument that sets the maximum memory (RAM) the server is allowed to use. Xmx stands for “maximum heap size,” and 1024m specifies 1024 megabytes (or 1 gigabyte). The server’s memory usage will not exceed this limit.
-Xms1024m: This is a JVM argument that sets the initial memory the server starts with. Xms stands for “initial heap size,” and 1024m again specifies 1024 megabytes.
- Why are they the same? Setting the initial and maximum memory to the same value is a common performance optimization. It tells the JVM to grab all the required memory at the start, preventing potential lag spikes that can happen when the server needs to pause and request more memory from the system during gameplay.
-jar: This is a standard Java flag that tells the JVM that the application you want to run is packaged inside a .jar (Java Archive) file.
minecraft_server.1.21.5.jar: This is the name of the actual server file you are running. The version number 1.21.5 indicates the specific release of Minecraft the server is for. Players will need to use the same game version to connect.
nogui: This is an argument passed directly to the Minecraft server application (not to Java). It tells the server to run in “headless” mode, meaning it will not open the typical graphical user interface (GUI) control panel. All server logs, chat, and commands will be handled directly within the command-line window. This is the preferred way to run a dedicated server because it uses significantly fewer system resources (CPU and RAM).

How The Minecraft Server Works

When you execute that command, here’s the sequence of events:

Launch: Your operating system runs the Java Virtual Machine.
Memory Allocation: The JVM immediately allocates a 1GB chunk of your system’s RAM for the server to use.
Execution: The JVM opens and runs the code contained within the minecraft_server.1.21.5.jar file.
Configuration: The server software starts up. It looks for server configuration files in its folder, such as:
- server.properties: This file contains all the main settings for your world, like the game mode (survival/creative), difficulty, world name, and the “Message of the Day” (MOTD) that players see.
- eula.txt: You must agree to Mojang’s End User License Agreement by changing eula=false to eula=true in this file the first time you run the server.
- ops.json, banned-players.json, etc.: Files that manage player permissions and restrictions.
World Loading: The server loads the game world data from its “world” folder. If a world doesn’t exist, it will generate a new one based on the settings in server.properties.
Ready for Connections: Once everything is loaded, the server starts listening for incoming connections from Minecraft game clients on your local network (and the internet, if you’ve configured port forwarding). The command-line window will typically display a message like [Server thread/INFO]: Done! For help, type "help".

java -xmx1024m -xms1024m -jar minecraft_server.1.21.5.jar nogui new — How to edit this Command in Minecraft Server: java -xmx1024m -xms1024m -jar minecraft_server.1.21.5.jar nogui updated

From this point on, the server’s primary job is to manage the game state. It processes player actions, runs the game’s logic (like mob spawning, crop growth, and physics), and sends updates back to all connected players to keep their game worlds synchronized.

You, as the administrator, can type commands directly into the terminal to manage the server in real-time.

A Complete Infographic Describing java -xmx1024m -xms1024m -jar minecraft_server.1.21.5.jar nogui Command:

Unlocking Your Minecraft Server

You’ve seen this command. Let’s break down what it *really* does.

java -Xmx1024m -Xms1024m -jar minecraft_server.1.21.5.jar nogui

The Command, Deconstructed

java

The core command. It tells your computer to run the Java Virtual Machine (JVM), the essential environment that executes all Java-based applications, including Minecraft.

-Xms1024m / -Xmx1024m

These are memory flags. -Xms sets the initial RAM, and -Xmx sets the maximum. Setting them to the same value is a key performance trick.

-jar

A standard Java flag. It signals to the JVM that the application it needs to run is packaged within the file that follows: a `.jar` (Java Archive) file.

minecraft_server…jar

The star of the show. This is the actual server file. The version number is critical, as players must have the same game version to connect successfully.

nogui

An argument for the Minecraft server itself. It means “no graphical user interface.” This runs the server in a lightweight, “headless” mode for maximum efficiency.

All Together

You’re telling Java to run the Minecraft server file with a pre-defined, stable amount of memory and no unnecessary visual interface.

Memory: The Engine of Your Server

Setting initial (-Xms) and maximum (-Xmx) memory to be the same is crucial for a smooth experience.

The Wrong Way: Mismatched RAM

Starts small, then freezes the game to ask the OS for more RAM, causing lag spikes.

The Right Way: Matched RAM

Grabs all the memory it needs at the start. No pausing, no asking, no lag.

The Startup Sequence

Command Executed

You press Enter. The operating system starts the Java Virtual Machine.

Memory Allocated

The JVM immediately reserves your specified 1024MB of RAM from the system.

Server JAR Loaded

The `minecraft_server.jar` code begins to run, looking for configuration files.

World Generation

The server loads your world files or generates a new one if none exists.

Ready for Players!

The server opens the network port and prints “Done!” in the console. Your world is live.

The ‘nogui’ Efficiency Edge

Running “headless” is the professional standard. The server’s visual interface is unnecessary and consumes valuable resources that could be used for gameplay.

On average, ‘nogui’ can save

~100MB+

of RAM

Why You Should Always Use It:

✓ Lower RAM Usage: More memory available for the actual game simulation.
✓ Lower CPU Load: The processor doesn’t waste cycles rendering a window you’re not looking at.
✓ Server Stability: Fewer components mean fewer potential points of failure or crashes.
✓ Automation Friendly: Headless servers are easier to manage with automated scripts and tools.

Axee Davies

Axee Davies is the founder of AxeeTech, publishing gaming guides, codes, and Windows how-tos since March 2013. A tech enthusiast for 13+ years — starting with smartphones and Android rooting — he now runs a site that puts out a new guide every day for Roblox players, traders, and Windows users. More about AxeeTech

axeetech.com