How to Upload a Server to MineKeep: Step-by-Step Guide (2026)

About 13 min

How to Upload a Server to MineKeep: Step-by-Step Guide (2026)

If you already have a Minecraft world or server and want to move it to MineKeep, you probably do not want to start everything again from scratch.

Your existing server may already contain months of progress, player inventories, plugins, configuration files, builds, permissions, and custom settings.

Fortunately, MineKeep provides a file manager that allows server owners to upload and manage server files. However, there is an important distinction to understand before starting:

Uploading a Minecraft server to MineKeep is not always the same as clicking one button and importing an entire server.

Depending on what you are moving, you may need to transfer your world, plugins, mods, and configuration files separately. MineKeep also provides an External Server option if you want to keep the Minecraft server hosted elsewhere while connecting it to the MineKeep network.

This guide explains how to upload a server to MineKeep step by step, what files you actually need, common migration problems, and when using a more flexible Minecraft host such as LightNode Game Server Hosting may make more sense.

Can You Upload an Existing Server to MineKeep?

Yes, but it depends on what you mean by "upload a server."

There are three common situations.

1. Upload an Existing Minecraft World

You already have a survival or creative world and want to continue playing it on MineKeep.

In this case, the most important files are your world folders.

2. Transfer an Existing Minecraft Server

You have a complete Paper, Spigot, Purpur, or compatible server containing:

World files
Plugins
Plugin configurations
Player data
Server settings
Whitelists
Operator lists

In this situation, you will need to migrate the compatible files into the appropriate MineKeep directories.

3. Keep the Server Elsewhere and Connect It to MineKeep

MineKeep also supports external servers.

Instead of physically moving all of your Minecraft server files to MineKeep, you can keep the backend running on another host and connect it to the MineKeep network.

This can be useful if you already have a VPS or dedicated Minecraft server with more resources.

We will cover all three scenarios below.

Before Uploading Your Server to MineKeep

Do not immediately start copying files.

A little preparation can prevent most migration problems.

Make a Full Backup First

Before changing anything, download a complete copy of your existing Minecraft server.

At minimum, keep copies of:

world/
world_nether/
world_the_end/
plugins/
mods/
server.properties
bukkit.yml
spigot.yml
paper-global.yml
paper-world-defaults.yml
whitelist.json
ops.json
banned-players.json
banned-ips.json

Your server may not contain every file listed above.

The exact files depend on the server software and Minecraft version you are using.

The most important rule is simple:

Never migrate your only copy of a Minecraft world.

Keep an untouched backup on your computer before uploading anything.

Step 1: Check Your Current Minecraft Version

Before transferring the server, determine which Minecraft version your original server uses.

For example:

Minecraft 1.21.1
Minecraft 1.21.4
Minecraft 1.20.6

Try to create the MineKeep server using the same Minecraft version.

Moving a world from one version to a newer version is sometimes possible, but downgrading a world is much more dangerous and can cause corrupted chunks, missing blocks, or broken data.

For the safest migration:

Old server version = New MineKeep server version

You can upgrade later after confirming the migration works.

Step 2: Check Your Server Software

The next thing to check is your server software.

Common Minecraft server software includes:

Vanilla
Paper
Spigot
Purpur
Fabric
Forge
NeoForge

This matters because plugins and mods are not universally compatible.

MineKeep supports Paper/Purpur-style plugins through its plugin environment.

For mods, MineKeep currently supports Fabric mods.

If your existing server runs Forge or NeoForge, you should not assume that its mods can simply be uploaded to MineKeep.

Before migrating a modded server, check every mod for compatibility.

Step 3: Create Your MineKeep Server

Choose:

Server name
Minecraft version
Appropriate server type
Public or private visibility

Once the server has been created, MineKeep will generate its own address.

A Java server normally uses an address similar to:

yourserver.minekeep.gg

Bedrock players can use the corresponding Bedrock address:

yourserver.bedrock.minekeep.gg

I recommend starting the new server once before uploading your old files.

This allows MineKeep to generate the standard directory structure.

After the first startup, stop the server before beginning the migration.

Step 4: Open the MineKeep File Manager

Go to the MineKeep Dashboard.

Find the server you created and open its management panel.

From the server management page, select:

Files

This opens the MineKeep File Manager.

This is where you can:

Browse folders
Create directories
Upload files
Manage plugins
Manage mods
Edit server-related files

If you have used a Minecraft hosting panel before, the layout should feel familiar.

Step 5: Stop the MineKeep Server Before Uploading Files

Do not replace world files while the Minecraft server is actively running.

Stop the server first.

This is especially important when replacing:

world/
world_nether/
world_the_end/

Minecraft continuously writes world and player data while the server is running.

Replacing files during that process can cause inconsistent data or corrupted saves.

A safer migration sequence is:

Stop server
↓
Upload files
↓
Verify directories
↓
Start server
↓
Check console
↓
Join and test

Step 6: Upload Your Minecraft World to MineKeep

Your Minecraft world is usually stored in a folder named:

world

A standard Java server may also contain:

world_nether
world_the_end

These contain the Overworld, Nether, and End dimensions.

Depending on how your old server is configured, the world name may be different.

You can check the following value in server.properties:

level-name=world

If it says:

level-name=survival

then your main world is likely called:

survival

What Should Be Inside a Minecraft World Folder?

A normal world directory may contain files and folders such as:

advancements/
data/
datapacks/
entities/
playerdata/
poi/
region/
stats/
level.dat
session.lock

The level.dat file is particularly important because it contains core information about the world.

Uploading the World

Using MineKeep's File Manager:

Open the server's root directory.
Locate the existing generated world.
Make sure the server is stopped.
Replace the generated world with your existing world files.
Confirm that the folder name matches the level-name setting.
Upload the Nether and End data if your original server uses separate dimension folders.
Restart the server.

After restarting, join the server and confirm that you appear in the correct world.

Step 7: Verify Player Data

Your Minecraft world contains more than buildings.

Player-specific information can also be stored in the world folder.

This includes:

playerdata/
advancements/
stats/

If these files are migrated correctly, returning players should normally retain things such as:

Inventory
Ender Chest
Position
Experience
Advancements
Statistics

However, Minecraft identifies players using UUIDs.

Authentication or server configuration changes can sometimes cause player identities to behave differently after migration.

For this reason, test with one known player account before inviting everyone back.

Step 8: Upload Plugins to MineKeep

If your previous server uses Paper, Spigot, or Purpur plugins, you may want to migrate them as well.

MineKeep provides a plugins directory for plugin files.

Open:

Files
→ plugins

If a plugins folder does not exist, create one named exactly:

plugins

Then upload the plugin .jar files.

For example:

plugins/
├── EssentialsX.jar
├── LuckPerms.jar
├── Vault.jar
└── WorldEdit.jar

After uploading the plugins, restart the server.

You can then check the plugin list using:

/plugins

If a plugin appears green, it is normally loaded correctly.

If it appears red or fails to load, check the console.

Common causes include:

Wrong Minecraft version
Missing dependency
Wrong plugin version
Unsupported server software
Broken configuration
Incompatible Java version

Step 9: Transfer Plugin Configuration Files

Installing the plugin .jar file alone may not restore your original setup.

Most plugins create their own folders inside:

plugins/

For example:

plugins/
├── Essentials/
├── LuckPerms/
├── WorldEdit/
├── CoreProtect/
└── PlaceholderAPI/

These directories can contain:

Permissions
Player homes
Economy data
Plugin settings
Messages
Database files
Warps
Logs

If you want your new MineKeep server to behave like the old one, transfer the relevant plugin configuration folders as well.

A good migration process is:

Upload the plugin .jar.
Upload its old configuration directory.
Verify compatibility with the new server version.
Start MineKeep.
Check the console for errors.

Do not automatically copy every old configuration file if you are changing major Minecraft or plugin versions.

Some plugins change their configuration format between releases.

Step 10: Upload Fabric Mods to MineKeep

MineKeep currently supports Fabric mods.

Open the MineKeep File Manager and locate:

mods/

If it does not exist, create a directory called:

mods

Then upload your compatible .jar files.

For example:

mods/
├── fabric-api.jar
├── lithium.jar
├── ferritecore.jar
└── your-mod.jar

Many Fabric mods require Fabric API, so make sure all dependencies are included.

Also check that every mod matches:

Minecraft version
Fabric version
Required dependencies

After uploading the files, restart the MineKeep server.

Important: Forge and NeoForge

Do not upload Forge or NeoForge mods expecting them to work in a Fabric environment.

Forge, NeoForge, and Fabric use different mod loaders.

If your previous Minecraft server is heavily based on Forge or NeoForge, migrating it directly to MineKeep may not be practical.

This is one situation where a VPS-based Minecraft server can be a better option because you have greater control over the server software.

Step 11: Upload Server Configuration Files Carefully

You may also want to migrate settings from your original Minecraft server.

Common files include:

server.properties
bukkit.yml
spigot.yml
paper-global.yml
paper-world-defaults.yml
whitelist.json
ops.json

However, I would not blindly overwrite every MineKeep-generated configuration file.

Hosting platforms sometimes require specific settings for their network architecture.

A safer approach is to compare the old and new configuration files and transfer only the settings you actually need.

For example:

difficulty=hard
gamemode=survival
max-players=10
view-distance=8
spawn-protection=0
white-list=true

Be especially careful with settings related to:

Server address
Ports
Authentication
Proxy configuration
Online mode
Networking

MineKeep handles several networking functions automatically, so replacing these settings with values from another host can prevent the server from starting or accepting players.

Step 12: Start the Server and Read the Console

Once the files have been uploaded, start the MineKeep server.

Do not immediately assume everything worked just because the server starts.

Watch the console carefully.

Look for messages containing words such as:

ERROR
WARN
Exception
Failed
Missing dependency
Unsupported
Could not load

Plugin errors are common after Minecraft migrations.

The server may technically start while individual plugins fail in the background.

Fix the errors one at a time before opening the server to your players.

Step 13: Join the MineKeep Server and Test Everything

Once the console looks normal, connect to the server.

Test the most important parts of your world.

Check:

Spawn location
Player inventory
Nether
The End
Plugins
Permissions
Homes
Warps
Whitelist
Operators
Commands
Datapacks
Player statistics

Do not delete your original server immediately.

I recommend keeping the previous host or backup untouched until you have confirmed the MineKeep migration is complete.

What If You Cannot Upload the Entire Server?

This is where the phrase "upload a server to MineKeep" becomes slightly misleading.

MineKeep provides file-management and upload functionality, but moving an entire Minecraft installation between hosting platforms is not always a single-click process.

Different hosts may use:

Different directory structures
Different Java versions
Different startup commands
Different proxies
Different server software
Different networking configurations

The safest strategy is usually to migrate the components that actually matter:

Server Component	Usually Worth Moving?
World	Yes
Player data	Yes
Plugins	Yes, if compatible
Plugin configs	Yes, if compatible
Fabric mods	Yes, if compatible
Forge mods	Not directly into Fabric
Logs	Usually unnecessary
Cache files	Usually unnecessary
Startup scripts	Usually no
Host-specific files	Usually no
Port configuration	Usually no

This produces a cleaner migration and avoids carrying unnecessary host-specific configuration into MineKeep.

Alternative Method: Connect an External Server to MineKeep

There is another option that many server owners overlook.

MineKeep supports External Servers.

This means your Minecraft server can remain hosted on your existing infrastructure while being connected to MineKeep.

Instead of moving your world, plugins, and server environment into MineKeep, MineKeep can act as the network-facing layer while the actual Minecraft backend remains elsewhere.

The general process involves:

Preparing your existing Minecraft server.
Configuring it to work with MineKeep's session server.
Enabling the PROXY protocol when appropriate.
Creating an external server through MineKeep.
Entering the backend server address and port.
Verifying the connection.

Once configured, players can connect through an address such as:

yourserver.minekeep.gg

This option can be useful if you already have a powerful VPS or another Minecraft server host and do not want to move all of your files.

MineKeep External Server + LightNode: A More Flexible Setup

If your main reason for searching "how to upload a server into MineKeep" is that your current server has become too restrictive, it is worth considering another architecture.

Instead of moving everything into another shared hosting environment, you can run the Minecraft backend on your own VPS-based game server.

One option I prefer for this type of setup is LightNode Game Server Hosting.

LightNode provides one-click Minecraft deployment on KVM VPS infrastructure.

For Minecraft, it currently provides support for:

Minecraft Java
Minecraft Bedrock
Plugins
Mods
Persistent world storage
One-click installation
NVMe SSD storage
40+ global server locations
Hourly billing
Monthly billing

LightNode recommends starting Minecraft servers with around 4 GB RAM or more, which gives significantly more room than a lightweight free hosting environment when running multiple plugins, larger worlds, or more players.

MineKeep vs LightNode for Minecraft Server Migration

The important difference is how much control you need.

Feature	MineKeep	LightNode
Free Hosting	Yes	No
Easy Minecraft Setup	Yes	Yes, one-click installation
File Manager	Yes	Full VPS-level control
Java Minecraft	Yes	Yes
Bedrock	Yes	Yes
Plugins	Yes	Yes
Fabric Mods	Yes	Yes / server-dependent
Forge / Other Custom Setups	More limited	Much more flexible
Root-Level Server Control	Limited	Yes
Custom Server Software	Platform dependent	Much more flexible
Global Location Choice	Platform controlled	40+ locations
Billing	Free + paid plans	Hourly + monthly
NVMe Storage	Not the main focus	Yes
Always-On Environment	Depends on plan	Yes while VPS is running
Scaling Resources	Plan-based	Flexible VPS sizing
Best For	Free/simple servers	Long-term/custom servers

For a small Minecraft server with a few friends, MineKeep is still the easier and cheaper choice because it has a free tier.

But if you are migrating a mature Minecraft server containing a large world, many plugins, mods, or custom server configurations, I would generally choose LightNode.

The biggest advantage is control.

You are not trying to adapt your existing server to a restricted shared hosting environment. Instead, you can run a more complete Minecraft server environment on your own KVM VPS.

That makes future migrations, backups, server software changes, and resource upgrades much easier.

Why I Prefer LightNode for Larger Minecraft Servers

MineKeep is a useful platform, especially when the goal is getting a small Minecraft server online for free.

But server migration often happens because the original server has grown.

Maybe you now have:

More players
A larger world
More plugins
More RAM usage
A modpack
Custom server software
Automated backups
Additional services

At that stage, infrastructure flexibility becomes much more important.

With LightNode Game Server Hosting, you can choose a location close to your players, select the required CPU and RAM, and retain significantly more control over the Minecraft server environment.

The hourly billing model is also useful during migration.

You can deploy a LightNode server, upload your existing world, test plugins and performance, and only continue using it once you are satisfied with the result.

That makes it particularly useful for server migrations where you do not want to immediately commit to a long hosting term.

LightNode Pros and Cons

Pros

One-click Minecraft server installation
KVM VPS infrastructure
Java and Bedrock support
Plugin support
Mod support
More control over Minecraft files
Better suited to custom server software
Persistent world storage
NVMe SSD
40+ global server locations
Hourly and monthly billing
Easy to increase server resources
Better suited to large or growing Minecraft communities

Cons

Currently does not support cryptocurrency payments

For a simple free Minecraft server, MineKeep still makes sense.

For a server that already has enough data and customization that you need a detailed migration guide, LightNode is often the more practical long-term option.

View LightNode Game Server Hosting

Common Problems When Uploading a Server to MineKeep

The Server Creates a New World Instead of Loading My Old One

Check:

level-name=

inside server.properties.

The value must correspond to the correct world folder.

For example:

level-name=survival

should match:

survival/

Also make sure your files were uploaded to the correct server directory.

My Plugins Do Not Work After Migration

Check:

Minecraft version
Paper/Purpur compatibility
Plugin version
Plugin dependencies
Java compatibility
Server console errors

Do not assume a plugin from an old Minecraft version will automatically work on a newer server.

My Mod Does Not Load

MineKeep's current mod documentation focuses on Fabric mods.

Check that you downloaded the Fabric version of the mod rather than Forge or NeoForge.

Also make sure Fabric API and any other required dependencies are installed.

Players Lost Their Inventories

Player inventory is normally associated with UUID-based player data.

Make sure you migrated the original:

world/playerdata/

directory.

Changes in authentication configuration can also affect UUIDs, so compare the original and new server setup.

The Nether or End Is Missing

Make sure the dimension data was transferred.

Depending on your server software, you may have directories such as:

world_nether/
world_the_end/

or dimension data inside the main world structure.

Do not transfer only the Overworld if you want to preserve all dimensions.

The Server Crashes After Uploading Files

Start by temporarily removing newly transferred plugins or mods.

Then read the console and identify the first meaningful error.

Common causes include:

Incompatible plugin
Wrong mod loader
Missing dependency
Wrong Minecraft version
Broken configuration
Insufficient RAM

Fix one problem at a time.

How Long Does a MineKeep Server Migration Take?

For a basic world with no plugins, the process can be fairly quick.

A more complex server may take considerably longer because you need to test compatibility.

A rough rule is:

Server Type	Migration Difficulty
Vanilla world	Easy
Small Paper server	Easy to moderate
Paper server with many plugins	Moderate
Large community server	Moderate to difficult
Fabric modded server	Moderate
Forge / NeoForge server	Difficult / may require another host
Custom proxy network	Advanced

The actual file upload itself is rarely the hardest part.

Compatibility testing is usually what takes the most time.

Should You Upload Your Server to MineKeep?

If your Minecraft server is relatively simple, MineKeep can be a convenient destination.

It works especially well for:

Small survival worlds
Friend groups
Lightweight Paper servers
Servers with a few plugins
Users who want simple hosting
Players trying to reduce hosting costs

However, if your server already uses substantial resources or relies on a highly customized setup, I would think carefully before moving it into a more restricted hosting environment.

At that point, a VPS-based solution such as LightNode gives you much more room to grow.

Final Thoughts

So, how do you upload a server to MineKeep?

The safest process is:

Back up your old Minecraft server.
Check the Minecraft version.
Confirm server software compatibility.
Create and start a MineKeep server once.
Stop the MineKeep server.
Open the MineKeep File Manager.
Transfer your world.
Transfer compatible plugins or Fabric mods.
Carefully migrate configuration files.
Restart the server.
Check the console.
Test the world before inviting players.

If you already host the Minecraft server somewhere else and do not want to migrate the backend, MineKeep's External Server feature provides another route.

For small, free Minecraft servers, MineKeep is attractive.

For larger or heavily customized servers, my overall preference is LightNode Game Server Hosting because the KVM VPS architecture gives you more control over server software, files, resources, locations, mods, and future scaling.

The most important thing during any Minecraft server migration is not speed.

Make a backup first, move the data carefully, and never delete your original server until the new one has been fully tested.

Frequently Asked Questions

Can I upload an existing Minecraft server to MineKeep?

You can move compatible Minecraft server data to MineKeep using its file management tools. This can include worlds, player data, plugins, plugin configurations, and compatible Fabric mods.

A complete server migration may require moving individual components rather than importing the entire server with one button.

How do I upload a world to MineKeep?

Create your MineKeep server, stop it, open the File Manager, and upload your existing Minecraft world files. Make sure the world folder corresponds with the level-name value used by the server.

Can I upload plugins to MineKeep?

Yes. MineKeep allows compatible plugins to be uploaded into the plugins directory using its File Manager.

Restart the server after installing plugins.

Can I upload mods to MineKeep?

MineKeep currently documents support for Fabric mods.

Upload compatible .jar files to the mods folder and install Fabric API or other required dependencies where necessary.

Does MineKeep support Forge mods?

MineKeep's current mod documentation specifies Fabric support and warns against installing Forge or NeoForge mods.

If your Minecraft server depends heavily on Forge or NeoForge, a more flexible VPS environment may be a better option.

Can I transfer my Minehut server to MineKeep?

The files that matter most are your world, player data, plugins, and compatible configuration files.

Download a complete backup from the original server first, then move the compatible files into the appropriate MineKeep directories.

You can also investigate MineKeep's External Server functionality if you intend to keep the backend server running elsewhere.

Can I connect another Minecraft host to MineKeep?

Yes.

MineKeep provides an External Server option that allows a Minecraft server hosted elsewhere to be connected to the MineKeep network after the backend has been configured correctly.

Will players keep their inventories after moving to MineKeep?

They normally can if the correct world and playerdata files are transferred and player UUIDs remain consistent.

Always test with an existing player account after migration.

What is the best alternative to MineKeep for an existing Minecraft server?

For a small free server, MineKeep is convenient.

For a larger existing server with plugins, mods, custom files, or increasing resource requirements, I prefer LightNode Game Server Hosting.

LightNode provides KVM VPS-based Minecraft hosting, one-click installation, NVMe storage, more than 40 global locations, hourly billing, and considerably more control over the underlying server environment.

Should I use MineKeep or LightNode?

Choose MineKeep if the main priorities are free hosting and simplicity.

Choose LightNode if the main priorities are server control, mods, resource flexibility, global location choice, long-term operation, and scalability.

For an established Minecraft server that already has a significant world, plugins, and player community, I would generally choose LightNode.