In this guide, we will show you how to install a modpack on your Minecraft server. We recommend installing modpacks to a fresh Minecraft server to avoid possible conflicts.
To connect to modded servers, we recommend using the CurseForge App to install modpacks to your local Minecraft client.
Larger packs may need more RAM allocated to your game client. You can adjust this in the CurseForge launcher settings.
Installing Modpacks
- Log in to the GhostCap Panel and select your Minecraft server.
- Open
Modpacks. - Search for the modpack you want.
- Click
Installto install the latest version, or click the arrow next toInstallto pick a version. - Read the warning and click
Installto confirm.
Your server starts by itself once the modpack is installed. You can follow the progress in Console.
Installing a modpack deletes every file on your server, including your world. If you wish to keep a copy of the current world, make sure to create a backup first! This installer does NOT create a backup of your world.
Updating an Existing Modpack
If you already have a modpack installed and want to update it to a newer version, or move back to an older one, the panel can switch versions for you.
- Log in to the GhostCap Panel and select your Minecraft server.
- Create a backup of your server in case you want to go back.
- Open
Modpacks. - Under
Installed modpack, clickUpdate to latest. To pick a different version, choose it from theChange versionlist and clickSwitch version. - Read the warning and click
Change versionto confirm.
Updating replaces the modpack's folders, such as mods, config, libraries, kubejs, and scripts, with the new version, including any mods you added and any config edits you made. Your world, server.properties, and backups are kept.
Manually Installing Modpacks
We recommend using CurseForge to find and install modpacks to your server and game client. Modpacks on CurseForge normally have a separate download for servers. This guide is suitable for most cases.
- Log in to the GhostCap Panel and select your Minecraft server.
- Click the version chip at the top of your server's page (it shows your current version, or
Set version). - Pick the mod loader your modpack uses, such as Forge or Fabric, and choose
Delete and reinstall. - Pick the Minecraft version your modpack needs and click
Install. - Use SFTP to upload the
Modpack.zipto your server's home directory. - Once uploaded, open
Files, open the menu onModpack.zip, and clickExtract. - Start your server.
Uploading a .zip is preferred as it's faster, but you can also upload everything uncompressed if you're having trouble. Normally, you'll only need the mods and configs folders uploaded.
Troubleshooting
Here are the most common issues you may run into when installing mods to your Minecraft server. We recommend following these in order.
Immediate Crashing
This may be because the server is using an incompatible Java version. Try these steps:
- Double-check that
Server Jar Fileis set correctly inSettings. - Change the Java version in the
docker_overwritefile and restart your server. See how to change your Java version. - Make sure the upload was successful. Files larger than 1GB need to be uploaded using SFTP.
Version Compatibility
Some modpacks won't have a premade server download and will need additional configuration. The easiest way to solve this is:
- Check the modpack's compatible mod loader and version on its download page.
- Make sure your Minecraft server has the correct game version installed if the modpack didn't include a
.jarfile. - Mod loaders such as Forge and NeoForge are different. While they may have similar names, they are NOT cross-compatible.
World Generation Crashing
Larger modpacks WILL require more resources. If your server is crashing when trying to generate the world:
- At the bottom of your server's page, under
Advanced, clickActivityand chooseCrashes, or watch your resources. If this is the issue, you will need to upgrade your server.
Connection Refused
If you've just manually installed a modpack and can't connect to your server, and your error message is just "connection refused" with no information:
- Restart your server.
- Make sure you've installed the modpack to your own game client.
- Ensure you're connecting with the correct IP address.
- If you're still unable to connect, reach out to us on Discord.
Mismatched Mods
Mods in modpacks will also need to be installed locally to your game client. If you have problems such as mismatched mods when trying to connect:
- Download the missing mods.
- Delete them from your game and server files then try again.


