DriversRecommendedOutdated drivers can make a good PC feel brokenScan driver issues before chasing fixes manually.Scan NowOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
VGSources
Blog

How to Install Purpur on a Minecraft Server

A complete Purpur installation guide covering Minecraft-version matching, Java requirements, launch commands, first-run setup, plugins, LAN and Internet access, backups, updates, and troubleshooting.
Length11 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Install Purpur by choosing the Minecraft version you want, downloading its matching Purpur JAR, installing the Java runtime required for that version, and launching the JAR from a dedicated server folder. Complete the first-run EULA setup, test locally, then configure plugins and network access. Purpur is a drop-in Paper replacement, so Paper-compatible behavior is retained while Purpur adds configurable gameplay options.

What Purpur is and why the installation approach matters

Purpur is a server implementation built as a drop-in replacement for Paper. Its purpose is to expose more configuration and optional gameplay features while retaining the upstream Paper feature set. If you leave purpur.yml unchanged, Purpur’s FAQ says running its JAR is no different from running Paper.

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The practical consequence is that you install Purpur much like a Paper server: select a Minecraft release, obtain the matching server JAR, run it with Java, accept the EULA, and place plugins in the generated plugins directory. The important differences are version matching, Purpur’s additional configuration files, and the need to check plugin authors’ compatibility notes before enabling non-default features.

Check these requirements before downloading

  • A fixed Minecraft version: Decide which release clients will use before downloading anything. A Purpur build is tied to a Minecraft version; do not choose a JAR first and try to fit the world around it.
  • A compatible Java runtime: Install the Java major version required by the target Minecraft release, not simply the newest Java available.
  • A dedicated folder: Keep the JAR, worlds, logs, configuration, plugins, and backups together in a location that is easy to reach from a terminal.
  • Enough host memory: The sample command below reserves 4 GB, but that is an example rather than a universal requirement. Player count, world size, plugins, operating-system overhead, and other services determine the sensible heap size.
  • A backup plan: Before a first migration, version change, or plugin experiment, make a copy of the world folders and configuration files.

1. Choose the Minecraft release and matching Purpur build

Write down the exact Minecraft version your players will run. Then select the Purpur build for that version from Purpur’s official download service. The documented latest-build endpoint follows this pattern:

#1 Best Overall
Sale
Gaoye Blue Light Blocking Glasses
  • BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
  • EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
  • COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
  • LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
  • WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.
https://api.purpurmc.org/v2/purpur/<version>/latest/download

Replace <version> with the Minecraft version you selected. For repeatable maintenance, record the version and build number in a notes file when you download it instead of relying only on a filename that may change later. The endpoint’s latest selector is convenient for a new installation, while a recorded build gives you a precise rollback point when updating.

Do not copy a world from one Minecraft version into another without a backup. World conversion can be one-way, and a failed upgrade is much easier to recover when the original directory is untouched.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

2. Install the Java version required by your Minecraft version

Java compatibility is determined by the Minecraft release. PaperMC’s current requirements table lists the following guidance:

Minecraft version Java major version
1.20 through 1.21.11 Java 21
26.1 and newer Java 25

Older Minecraft releases use different Java versions, so consult the requirements for the specific release you selected rather than assuming Java 21 or Java 25 applies to every historical version.

After installing Java, verify that the command is available in the same account that will run the server. A terminal should recognize java; if it does not, install the runtime again or correct the operating system’s PATH configuration. If the server reports a class-version or unsupported-Java error, compare the installed major version with the Minecraft release table and switch to the required runtime.

3. Create a clean Purpur server directory

Create one folder exclusively for this server. A short path without confusing punctuation makes command-line work and backup scripts simpler. The folder will eventually contain files such as:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Windex Gaming Cleaning Wipes, Pre-Moistened Wipes to Instantly Clean all Gaming Gear and Electronics, Resealable Packaging for a Freshness Lock, 25 count (Pack of 1)
  • WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
  • AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
  • PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
  • ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
  • COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed
  • the Purpur server JAR;
  • server.properties and the EULA file generated during first launch;
  • world directories, logs, and crash reports;
  • Paper and Purpur configuration files; and
  • the plugins directory and plugin data.

Download the selected JAR into this folder and rename it to a stable name such as purpur.jar. Keeping the filename stable means a start script does not need to change every time you install a new build. Preserve the original release and build information in a text file or backup folder so you can identify exactly what was running.

4. Launch Purpur from the server directory

Open a terminal in the directory containing purpur.jar. The documented Paper launch pattern works for Purpur when the filename is changed:

java -Xms4G -Xmx4G -jar purpur.jar --nogui
  • -Xms4G sets the initial Java heap size.
  • -Xmx4G sets the maximum heap size.
  • -jar purpur.jar tells Java which server file to execute.
  • --nogui disables the Vanilla graphical interface, which is useful on a headless machine and leaves the console as the control surface.

The two 4 GB values are only a starting example. Allocate enough memory for the intended player count, world and plugin load, while leaving capacity for the operating system and other services. Giving the JVM all available RAM can make the host less stable even if the server itself appears to have more memory.

Once this command works, save it in a Windows batch file or a macOS/Linux shell script. Keep the script in the server folder and change the heap values only after observing the server’s workload and the host’s remaining memory.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

5. Complete first-run setup and accept the EULA

On its first launch, Purpur creates the initial directory structure and configuration files, then follows the EULA setup process. Read the generated instructions, make the required EULA choice, and stop and restart the server as directed. Do not treat a server that has merely created files as fully configured: allow the first startup to finish, then stop it cleanly before making broad changes.

After the restart, inspect the console for startup errors. Confirm that the expected world directories, logs, server.properties, and configuration files exist. If you are migrating an existing world, stop the new server first, make a complete backup, and then copy the world into the server directory rather than overwriting files while the process is running.

Rank #3
Sale
LISEN Cell Phone Stand Phone Holder for Desk, Office Decor Gadgets for Men
  • Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
  • Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
  • Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
  • ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
  • Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)

6. Configure and test the server locally

Begin with a connection from the same machine or local network before opening the server to the Internet. This separates Minecraft and plugin problems from router and firewall problems.

Review the core server settings

  • Set the server name and gameplay options in server.properties.
  • Check operator permissions and grant operator status only to accounts that need administrative commands.
  • Review view distance and simulation distance. These settings affect CPU and memory load, so raise them deliberately rather than assuming the largest value is best.
  • Confirm world settings and the selected game mode before inviting players.

Test a local connection

  1. Start Purpur and wait until the console indicates that startup has completed.
  2. Use the host machine’s local connection option, or the host’s private LAN address from another device on the same network.
  3. Join with a client running the exact Minecraft version selected for the server.
  4. Walk through the world, place and break blocks, and check that the console remains free of repeating errors.
  5. Stop the server using its clean console stop command before editing files or taking a backup.

A successful local test confirms that Java, the JAR, the world, and the basic configuration work. It does not yet prove that players outside your network can connect.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

7. Add plugins without creating avoidable incompatibilities

Purpur inherits Paper features by design. Purpur’s FAQ also says that Paper, Spigot, and CraftBukkit plugins generally work. Compatibility is not guaranteed, however: a plugin can fail when its author hard-codes support for a particular server implementation or ignores Paper and its forks.

Use a controlled plugin installation sequence

  1. Read the plugin’s documentation and confirm that its Minecraft version and supported server implementations include your target release.
  2. Stop Purpur cleanly before placing a plugin JAR in the plugins directory.
  3. Add one plugin, start the server, and inspect the console for enable errors before adding another.
  4. Test the plugin’s commands and features in a disposable world or after taking a backup.
  5. Record the plugin version alongside the Purpur build so a later failure can be traced to a specific change.

Purpur-specific options are stored in its configuration files. Change one setting at a time, document what you changed, and restart when the setting requires a restart. Avoid using /reload as a plugin lifecycle strategy; a clean stop and start gives plugins a predictable initialization sequence and makes backups safer.

8. Let friends connect: LAN versus Internet access

Players on the same local network

LAN players connect to the host computer’s private address. Use the server’s local address rather than its public Internet address, and make sure the operating system firewall allows the Java server process to receive connections. The local test should work first; if it does not, fix the server or host firewall before changing router settings.

Players outside your home network

Internet players need more than a running Purpur process. You must allow the server through the host firewall, forward the Minecraft listening port from the router to the server machine, and give players a stable public address or DNS name. Router interfaces and firewall rules differ by operating system, router model, and network provider, so there is no single command that is correct for every setup.

Rank #4
Ledagic IC+RGBW USB Powered Led Light Bar with App & Remote Control, 2 Pack
  • Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
  • Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
  • 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
  • Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
  • USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC

Test from a different network, such as a phone connection, rather than testing only from inside the same LAN. Some routers do not support loopback connections, so an internal test of the public address can fail even when outside players can join. If inbound connections are impossible because of carrier-grade NAT or provider restrictions, a VPN-based connection is an alternative; all players then use the VPN network instead of a direct public port.

The Minecraft Wiki’s server tutorial covers LAN connection, port forwarding, VPN alternatives, and client connection details. Whichever method you use, share only the address and port players need, keep operator privileges restricted, and do not expose unrelated services on the host.

9. Back up and update Purpur safely

Updates affect the server JAR, plugins, configuration, and sometimes the world format. Use this sequence for every planned upgrade:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
  1. Announce downtime and stop Purpur cleanly.
  2. Copy every world directory, server.properties, Purpur and Paper configuration files, plugin data, and any scripts into a dated backup.
  3. Record the current Purpur version, build, Java major version, and plugin versions.
  4. Choose the intended Minecraft version and download the matching Purpur build. The versioned Purpur API makes it possible to select a Minecraft version and, when needed, a reproducible build rather than downloading an unrelated release.
  5. Replace the JAR or place the new JAR beside the old one and update the start script to point to it.
  6. Read plugin release notes and remove or update plugins that do not support the new Minecraft or Purpur release.
  7. Start the server and watch the entire console for conversion notices, plugin errors, or repeated warnings.
  8. Connect locally, verify worlds and essential features, and only then reopen public access.

Keep the previous JAR and its matching backup until the new version has been exercised. If the upgrade fails, stop the server, restore the prior JAR and backup, and investigate from a known-good state instead of repeatedly launching a partially upgraded directory.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Common installation problems and the fastest diagnosis

Java is missing or the wrong version is running

If the terminal cannot find java, install the required runtime or correct PATH settings. If Java starts but rejects the JAR with a class-version error, the installed major version does not match the Minecraft release. Recheck the Java table and run the server with the appropriate runtime.

The JAR cannot be found

A “file not found” startup failure usually means the terminal is in a different directory or the filename differs from the command. Open the terminal in the folder containing the JAR, list the filename, and make the command and actual filename identical. Renaming the file to purpur.jar avoids build-number typos.

Best Value
Sale
HUANUO FlowLift™ Dual Monitor Stand, Fully Adjustable Gaming Monitor Desk Mount for 13–32″ Computer Screens, Full Motion VESA 75x75/100x100 with C-Clamp & Grommet Base, Each Arm Holds 4.4 to 19.8 lbs
  • Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
  • Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
  • Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
  • Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
  • Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.

The first launch stops before a server is available

Read the generated first-run instructions and complete the EULA step, then restart. Do not copy a configuration from another version until the clean first-run files have been created and backed up.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

A plugin fails while Purpur itself starts

Separate server startup from plugin startup in the console. Check the plugin’s documented Minecraft and server support, then test with that plugin removed. Hard-coded CraftBukkit or Spigot assumptions can cause incompatibility even though most Paper, Spigot, and CraftBukkit plugins work on Purpur.

Local players can join but Internet players cannot

The server process is working; focus on the host firewall, router port forwarding, the destination machine’s private address, and whether the network provider blocks inbound connections. Test from an external network and verify that players are using the current public address or DNS name.

The server is lagging or the host runs out of memory

Do not assume that increasing -Xmx alone will solve performance problems. Check player count, world activity, plugin behavior, view distance, simulation distance, and memory left for the operating system. There is no universal Purpur RAM value; tune the heap and distances for the actual host and workload, then retest after each change.

Self-hosting versus managed hosting

Running Purpur on your own computer gives you direct control, but it also makes you responsible for networking, backups, updates, and uptime. A managed host can reduce routine administration at the cost of less control over the machine and Java process. The relevant choice depends on who will operate the server, not on a single “best” hosting type.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Decision area Self-hosted Purpur Managed hosting
Files and JVM flags Direct control of the JAR, scripts, configuration, and heap flags. Control depends on the host’s panel and policies.
Cost Uses hardware and network service you already operate, with those ongoing costs remaining your responsibility. Usually charged as a service; the exact price and resource allocation depend on the provider.
Backups You must create, verify, and retain world and configuration backups. The provider may offer backup tools, but you still need to understand retention and restore behavior.
Network exposure You configure the firewall, router, public address, or VPN path yourself. The provider normally supplies an Internet endpoint, while its network rules govern access.
Uptime Depends on your hardware, power, Internet connection, and maintenance schedule. Depends on the provider’s infrastructure and service terms.
Player capacity Limited by your machine’s CPU, memory, storage, and network connection. Limited by the plan’s assigned resources and upgrade options.
Plugin and configuration support You can install compatible plugins and edit Purpur settings directly. Available plugins and settings depend on the host’s controls and policies.
Upgrades You choose the build, schedule downtime, and perform backups and compatibility checks. A control panel may simplify upgrades, but you remain responsible for checking worlds and plugins.

A reliable operating routine

  • Keep the launch command and the exact Purpur, Java, and plugin versions in a maintenance note.
  • Back up before every version, plugin, or world change, and test that a backup can actually be restored.
  • Use local testing for configuration changes before reopening the public endpoint.
  • Change one major variable at a time so a plugin, heap, distance, or Purpur setting can be associated with its effect.
  • Stop the server cleanly before copying worlds or configuration files.
  • Review console output after every restart, especially after a Minecraft-version change.

With those controls in place, Purpur installation is straightforward: match the Minecraft and Java versions, launch the correct JAR from its own directory, establish a clean local server, and expose it to other players only after backups and compatibility checks are in place.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.