All posts
August 7, 2026·4 min read

Running a Forge Server With Mods on Your Own Computer: Setup and Errors Explained

How to set up a Forge server locally: the installer with the --installServer flag, eula.txt, the mods folder, and run.bat. Plus a breakdown of common startup errors and mod conflicts.

The entire first page of results for "forge create a server" is hosting-company knowledge bases. Their logic is obvious: the article ends with a rent-a-server button.

A Forge server runs perfectly well on an ordinary computer, though. For playing with a couple of friends, that's enough — and for building a modpack, running it locally is the only sane way to check that it even starts.

Installation

Download the installer for the version you want from Forge's site — not "universal," not "mdk," specifically installer. Put it in an empty folder; that matters, because the installer creates a lot of files next to it.

Then, from the command line in that folder:

java -jar forge-1.21.1-52.0.0-installer.jar --installServer

Substitute your own filename. The --installServer flag is required: without it, you get the graphical client installer instead of the server one.

The installer downloads the engine and creates launch scripts: run.bat for Windows and run.sh for Linux and macOS.

First launch

Run run.bat. The server comes up and immediately shuts down — that's expected.

An eula.txt file has appeared in the folder. Open it and change the line:

eula=false

to eula=true. That's you accepting the Minecraft license. Without this, the server won't start, and no other configuration will fix it.

Run run.bat again. Now the server loads, generates a world, and starts listening on the port. You can connect at localhost.

If the installer crashes with a message about an invalid e-tag checksum, the vanilla server didn't finish downloading. The fix is installing a regular Minecraft server into the same folder before running the Forge installer.

Mods

After installation, there's a mods folder inside the server directory. .jar files go there, and that's the entire mod-installation process.

Three rules that save you evenings.

Versions have to match. A mod built for 1.20.1 won't work on a 1.21.1 server. This is the single most common cause of a startup crash.

Server-side and client-side mods are different things. Some mods are only needed on the client, some only on the server, most on both. A mod installed in the wrong place will do nothing at best, and prevent connections at worst.

Add a few at a time. A modpack of forty mods installed all at once is undiagnosable when it crashes.

What to do when the server won't start

Look in logs/latest.log. The answer is almost always there — the only question is finding it among thousands of lines.

What to search for, in order:

  • a line with Caused by — it usually names the actual cause;
  • a mod name next to the exception — the culprit is often named outright;
  • messages about Missing or unsupported mandatory dependencies — a mod needs a library that isn't there;
  • Incompatible mod set — a version conflict.

"The server starts, but the player can't connect" is a separate class of error — check the port, the client version, and whether the mod set matches.

Where an agent helps here

Debugging a modpack is reading logs and cross-checking versions. It's mechanical, high-volume work: Forge logs are verbose, and forty mods' worth of dependencies don't fit in your head.

What goes away entirely: finding the actual crash cause in latest.log and explaining it; compiling the list of installed mods with versions and checking it against the server version; verifying which libraries are missing; comparing the server's mods folder against the client's and showing the difference.

Doka reads logs and folders directly, so "why won't it start" is one sentence instead of pasting walls of text into a chat. You can keep the model local and put server launches on a schedule. Download it for free.

Local or hosted

A local server is great for building, testing, and playing with friends over the network or through a tunnel. It costs nothing and restarts instantly.

Hosting matters once the server needs to run without your computer — that is, around the clock, for people who show up whenever they feel like it. That's the only real reason to pay.

A sensible order: build and debug the setup locally, then move the whole folder over. Settings and mods carry over as-is.

Want to write your own mod instead of installing others' — start here. If the task is really about recipes and loot, you might not need a mod at all: a data pack handles that without Java. And for setting up a game server for a different game with the same "start local" approach, see the article on a DayZ server.