What you need to build a modded server at home
A modded Minecraft server runs on your own computer using free software, but it requires more processing power and memory than vanilla Minecraft. You will need a Windows, Mac, or Linux machine that stays on while players connect — a laptop left running 24/7 uses real electricity, so many people use an older desktop or a Raspberry Pi instead. The server software itself is free, but you choose which mods to install based on what your players want.
The basic path is: install Java (which Minecraft runs on), read server software that supports mods, add the mods you want, configure settings, and tell your friends your computer's local network address so they can join. This is different from renting a server from a hosting company — you control everything, pay nothing monthly, but you also handle all the setup and troubleshooting yourself.
Key Takeaways
- A modded server needs Java installed first, then mod-compatible server software like Forge or Fabric, then the actual mod files placed in the right folder.
- Your friends connect using your computer's local IP address (like 192.168.1.100) if they are on the same home network, or your public IP address if they are playing from outside your home.
- The computer running the server must stay powered on and connected to the internet the whole time people are playing.
- Common beginner mistakes are installing mods in the wrong folder, forgetting to allocate enough RAM to the server, and not checking that Java is the 64-bit version.
Installing Java and choosing server software
Minecraft servers run on Java, so you must install it first. read the latest version of Java from java.com or adoptium.net — choose the 64-bit version, not 32-bit, because modded servers need more memory. Install it, then verify it worked by opening a command prompt (Windows) or terminal (Mac/Linux) and typing java -version. You should see a version number appear.
Next, choose server software that supports mods. The two most common are Forge and Fabric. Forge is older and works with more mods, but Fabric is lighter and faster if you only want a few mods. Go to files.minecraftforge.net or fabricmc.net, read the installer for the Minecraft version you want (like 1.20.1), and run it. The installer creates a folder with everything you need to start the server.
Adding mods to your server
Mods are files that change how Minecraft works. You find them on CurseForge (curseforge.com) or Modrinth (modrinth.com), which are the main mod repositories. Search for mods you want, but check that each mod is compatible with your server software — a Forge mod will not work on Fabric, and vice versa. Also check the Minecraft version: a mod made for 1.20.1 will not load on 1.19.2.
Once you read a mod file (usually a .jar file), place it in the mods folder inside your server directory. Do not put it anywhere else — the server only looks in that one folder. If the mods folder does not exist yet, create it yourself. After you add mods, restart the server and watch the console output to see if they load without errors. If a mod fails to load, the console will print an error message telling you why.
Allocating memory and starting the server
Modded servers use a lot of RAM (memory). By default, the server might only use 1 GB, which is not enough. You need to tell it to use more — usually 4 GB to 8 GB depending on how many mods you have and how many players will join. On Windows, create a text file called run.bat in your server folder and paste this line into it:
java -Xmx6G -Xms6G -jar forge-1.20.1-47.2.0.jar nogui
Change the 6G to however many gigabytes you want to give it, and change the forge filename to match the actual file in your folder. Save the file, then double-click it to start the server. On Mac or Linux, create a file called run.sh with the same command, make it executable by typing chmod +x run.sh in the terminal, then run it. The server will start and print messages to the console. When you see "Done" at the end, players can connect.
Connecting players on your home network
If your friends are on the same WiFi or ethernet as your server computer, they connect using your local IP address. Find it by opening a command prompt and typing ipconfig (Windows) or ifconfig (Mac/Linux), then look for the address that starts with 192.168 or 10.0. Tell your friends to open Minecraft, click "Multiplayer," then "Add Server," and paste that address into the server address field. They should see the server appear and be able to join.
If your friends are outside your home network, they need your public IP address instead. You can find it by searching "what is my IP" in a web browser. However, this requires you to set up port forwarding on your router, which is more complex and creates security risks if done incorrectly. Most home networks are not set up for this, and many internet providers block it. For friends outside your home, a simpler option is to use a tunneling service like Ngrok or Tailscale, which creates a find connection without touching your router settings.
Troubleshooting mods that do not load
When you start the server, watch the console output carefully. If a mod fails to load, the error message usually tells you why — common reasons are a missing dependency (another mod that this mod needs), a version mismatch (the mod was made for a different Minecraft version), or a conflict with another mod. Search the mod's page on CurseForge or Modrinth for a changelog or compatibility list to see if it works with your setup.
If the server crashes on startup, the most common cause is not enough RAM allocated. Try increasing the number in your run.bat or run.sh file by 2 GB and restart. If that does not help, remove half your mods and start the server again — if it works, add mods back one at a time until you find the one causing the crash. Keep the console window open while playing so you can see error messages in real time.
Managing server settings and player permissions
The server creates a file called server.properties when it starts for the first time. Open it in a text editor to change settings like the world name, difficulty level, whether PvP is on, and the maximum number of players. Changes take effect when you restart the server. If you want to give certain players special permissions (like the ability to use commands), you can edit the ops.json file and add their usernames, then restart.
For more complex permission systems, you can install a permissions mod like LuckPerms, which lets you create groups and assign different rules to different players. This is optional for small servers with friends you trust, but useful if your server grows. Like any other mod, read it from CurseForge or Modrinth, place it in the mods folder, and restart the server.
Frequently Asked Questions
Can I run a modded server on a laptop?
Yes, but laptops get hot and use a lot of power if left on constantly. A desktop computer or Raspberry Pi is better for a server that runs all the time. If you only want to play with friends for a few hours at a time, a laptop works fine.
What happens if I add mods after the server is already running?
Stop the server, add the mod files to the mods folder, then restart. Players will need to have the same mods installed on their client side, or they will see errors when they try to join. Both the server and the client must have identical mod lists.
Do my friends need to install mods on their computers too?
Yes. If your server has mods, each player must install the exact same mods on their own Minecraft launcher. The easiest way is to use a launcher like CurseForge's launcher or Prism Launcher, which can read and install a whole modpack at once instead of doing it manually.
How much does it cost to run a modded server at home?
The software is free, but you pay for the electricity to keep your computer running. A desktop computer uses roughly 100 to 300 watts, which costs a few dollars per month depending on your local electricity rates. A Raspberry Pi uses much less power.
What if my internet goes down?
Your friends will lose connection to the server. The world data is saved on your computer, so nothing is lost — they can reconnect when your internet is back. If you need the server to be up all the time, you need a computer that does not lose power during outages, like one on a battery backup.