Installation
Learn how to install Magma on your server
Installing Magma
This guide will walk you through the process of installing Magma on your server. Magma combines the functionality of NeoForge mods and Bukkit plugins, giving you the best of both worlds for your Minecraft server.
System Requirements
Before installing Magma, ensure your system meets the following requirements:
- Java: Java 21 or newer is required
- RAM: Minimum 4GB RAM recommended (more for larger modpacks)
- CPU: Dual-core processor or better recommended
- Storage: At least 2GB available for the server (more for mods and world data)
- Network: Stable internet connection with port forwarding capability
Download and Install Magma
Magma offers two main ways to install:
Option 1: Using the Installer (Recommended)
- Visit the Magma downloads page
- Download the installer (e.g.,
magma-21.1.29-beta-installer.jar
) - Create a new folder for your Magma server
Option 2: Using the Launcher (For versions 1.40-beta and above)
- Visit the Magma downloads page
- Look for the orange "Launcher" button for versions 1.40-beta and above
- Download the launcher JAR file (with the
-launcher.jar
suffix) - Create a new folder for your Magma server
Option 3: Quick Download (Command Line)
If you prefer using the command line, you can download the latest launcher directly:
This direct URL always points to the latest launcher version, making it ideal for server setup scripts and automation.
Installation Steps
Installer Method (All Versions)
- Move the downloaded installer (e.g.,
magma-21.1.29-beta-installer.jar
) to your server folder - Run the installer with the following command:
- The installer will set up everything needed for your Magma server
Launcher Method (Version 1.40-beta and above)
- Move the downloaded launcher JAR (e.g.,
magma-21.1.29-beta-launcher.jar
) to your server folder - Run the launcher directly with:
- The launcher will guide you through the setup process
Running the Server
Windows
After installation is complete, run the server using the provided batch file:
Linux/macOS
After installation is complete, run the server using the provided shell script:
First-Time Setup
When you start the Magma server for the first time:
- The server will generate configuration files and then stop
- Edit the
eula.txt
file and changeeula=false
toeula=true
to accept the Minecraft End User License Agreement - Start the server again using the appropriate script for your operating system
- The server will fully start up and generate the world
Next Steps
Now that your Magma server is installed, you can:
- Learn how to add mods to your server
- Set up Bukkit plugins for enhanced functionality
If you encounter any issues during installation, see our troubleshooting guide.