October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run ScanOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
World desk11 min

How to Install Purpur on a Minecraft Server

A complete Purpur installation guide covering Java requirements, the launch command, first-run setup, Paper and Spigot plugin compatibility, backups, updates, and router configuration.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Install Purpur by selecting the Minecraft version you want, installing the Java runtime that version requires, placing the matching Purpur JAR in a dedicated folder, and launching it from that folder with Java. On first launch, accept the EULA through the generated instructions, configure the server, test locally, and only then open access to other players. Purpur is a drop-in Paper replacement: it keeps Paper’s upstream features while adding configurable behavior and optional gameplay features.

What Purpur is and when it is the right choice

Purpur is a Minecraft server implementation built as a drop-in replacement for Paper. Its purpose is to expose more configuration and add optional gameplay features while retaining Paper compatibility. If you leave purpur.yml unchanged, Purpur’s own FAQ says running the 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.

That makes installation familiar to anyone who has run a Paper server: you still choose a Minecraft release, use the matching Java runtime, launch one JAR from a server directory, edit the normal server files, and install plugins in the plugins folder. The important difference is that Purpur-specific settings become available when you need them.

Check these requirements before downloading

  • A fixed Minecraft version: choose the release your players and plugins will use before selecting a Purpur build. A server JAR and client on different protocol versions generally cannot connect reliably.
  • The matching Java runtime: install the Java version required by the chosen Minecraft release, not simply the newest Java available on your computer.
  • A dedicated directory: keep the JAR, worlds, logs, configuration, plugin files, and backups together in a location you can reach from a terminal.
  • Enough host memory: the example command below allocates 4 GB, but that is a starting point rather than a universal requirement. Player count, world size, plugins, operating-system overhead, and other services determine the appropriate heap.
  • Administrative access: you need permission to install Java, create files, open the server process through the firewall, and change router settings if players will connect over the internet.

Choose the Minecraft release and Java version together

PaperMC’s current requirements table lists these Java mappings:

#1 Best Overall
Sale
TOZO A1 Wireless Earbuds Bluetooth 5.3 Light Weight in Ear Headphones | IPX5 Waterproof,2 Mics for AI Calls,Immersive Premium Sound Bass Headset with Charging Case,32 EQ via App Black
  • [Ultra-Lightweight Ear Buds Designed for Small Ears] Each earbud weighs only 3.7g and features a compact, ergonomic in-ear design made especially for small ears. Secure, low-profile, and comfortable for workouts, all-day wear or overnight sleeping.The ultra-slim profile sits flush in your ear with no hard edges poking or rubbing, so you can even sleep on your side without discomfort.
  • [Immersive Stereo Sound with TOZO OrigX Technology] TOZO OrigX tuning delivers clear vocals, balanced mids, and natural stereo sound for music, podcasts, and videos.
  • [Long Battery Life for Daily Use] Get up to 7 hours of playtime on a single charge, with up to 32 hours total using the charging case—ideal for workdays, commuting, and extended listening sessions.
  • [Bluetooth 5.3 & Stable Connection] Bluetooth 5.3 provides fast pairing, stable wireless performance, and reduced dropouts as you move around home or office.
  • [Deep Bass with Clear Vocals] High-performance drivers produce punchy bass while keeping vocals clean and detailed for everyday listening.
Minecraft release Java runtime listed by the current table What to do
1.20 through 1.21.11 Java 21 Install a 64-bit Java 21 runtime and make sure the java command resolves to it.
26.1 and later Java 25 Install a 64-bit Java 25 runtime before starting the server.
Older releases Depends on the release Check the requirements for that particular Minecraft version; do not assume Java 21 or Java 25 is correct.

After installing Java, verify what your terminal will use:

java -version

The reported major version must match the Minecraft release you selected. If several Java installations are present, correct the operating system’s PATH or call the intended Java executable by its full path in your start script.

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

Download the matching Purpur JAR

Use the versioned download endpoint

Purpur publishes a latest-build API endpoint in this form:

https://api.purpurmc.org/v2/purpur/<version>/latest/download

Replace <version> with the exact Minecraft version you selected. The endpoint then downloads the latest Purpur build available for that Minecraft version. A versioned path is preferable to downloading an unlabelled file because your notes and update process can record which Minecraft release you intended to run.

Create a stable filename

Save the downloaded file in your server directory and rename it to purpur.jar. Keeping a stable filename means your launch script does not have to change every time you update the build. Record the original version and build in a text file, or keep the old JAR outside the active directory as a rollback reference.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #2
Sale
Smart Watch for Men Women Compatible with iPhone Samsung Android Phone 1.69 inch Full Touch Screen IP68 Waterproof Bluetooh Fitness Tracker Heart Rate/Sleep Monitor (Black)
  • 【IP68 Waterproof Multifunctinal Smart Watch】Torjalph fitness activity tracker smart watch is IP68 waterproof technology ,you can wear it when swimming,handwashing,it's rain-proof which means that you perform multiple exercise modes outside without worrying about sweat or rain corroding your fitness smart watch,and this watch equipped with a 230 mAh large capacity battery magnetic charging ,and this sports activity tracker watch can be used 5-7 days If fully charged.
  • 【Larger 1.83'' Full Screen Watch & Multi-dial Selection】1.83 inch full HD color touch screen smart watch for men / women provides excellent 240*284 resolution image quality ,This Bluetooth smart watch offers a better touch experience and remarkable immersion and ,more than 200 watch faces for you to choose from App"Da Fit ", you can change the dial style according to your mood to wear keeping the world on your wrist
  • 【Accurate Activity Tracker Smart Watch 】sports watch activity tracker uses sweat and dust resistant breathable silicone strap, our Fitness Tracker Smart Watch for Android iOS Phones supports 12 sports modes,walking,running,bicycle,swimming,badminton,basketball,football,rope skipping. This bluetooth calls smart watch for men women is lightweight and stylish, bringing more convenient and relaxing sports experience while also providing more protection.
  • 【Your 24 Hour Personal Daily Health Monitor】Fitness watch for women men full touch screen IP67 waterproof bluetooth smartwatch for Android iOS Phones with heart rate blood pressure monitor multifunction Andriod smart watch with steps counter sleep monitor sports fitness watch, monitoring blood oxygen saturation allows you to understand your physical condition in real time to track fitness progress ,to know your health status in time.
  • 【More Functions Bluetooth Call Smart Watch】This fitness activity smart watch full screen for iPhone and Android phones includes a bunch of new features including:The bluetooth smart watch can hang up the phone, receive and display WhatsAPP /Text /Facebook /Twitter /Messenger reminder.Support sedentary reminder, alarm clock, stopwatch, timer,weather information,music control, remote camera control compatible with Android 5.0 and above or iOS 9.0 and above smartphones.

Do not place the JAR in your general Downloads folder and launch it from somewhere else. The server writes relative paths for worlds, logs, and configuration; starting in the wrong directory can make it appear that files have disappeared or create a second, unintended server.

Set up the server directory

Choose a path that is easy to back up and reach from a terminal. For example, use /srv/minecraft/purpur on Linux or macOS, or C:MinecraftPurpur on Windows. Put purpur.jar there before the first launch.

A practical directory will eventually contain:

  • purpur.jar, the active server executable.
  • server.properties, the standard server settings.
  • purpur.yml and other generated configuration files, where applicable.
  • World directories, logs, operator and whitelist files, and the plugins directory.
  • A separate backup location containing copies made while the server is stopped.

Keep backups outside the live world directory. A backup stored beside the files it is meant to protect can be lost in the same disk failure or accidental deletion.

Start Purpur from the command line

Linux or macOS

  1. Open a terminal.
  2. Change to the directory containing the JAR: cd /srv/minecraft/purpur.
  3. Start the server:
java -Xms4G -Xmx4G -jar purpur.jar --nogui

Windows

  1. Open Command Prompt or PowerShell.
  2. Change to the server directory: cd /d C:MinecraftPurpur in Command Prompt.
  3. Run the same Java command:
java -Xms4G -Xmx4G -jar purpur.jar --nogui

Understand each launch option

Option Meaning Adjustment guidance
java Runs the Java runtime found through your system path. If the wrong runtime is selected, fix Java installation or use its full executable path.
-Xms4G Sets the initial Java heap to 4 GB. Increase or decrease it only after considering the host’s total memory and other services.
-Xmx4G Sets the maximum Java heap to 4 GB. This is an example starting point, not a Purpur requirement or a player-capacity guarantee.
-jar purpur.jar Runs the named Purpur JAR. The filename must exactly match the file in the current directory.
--nogui Disables Vanilla’s graphical server window. It is useful for headless machines and leaves the console as the control interface.

Once the command works, place it in a Windows .bat file or a macOS/Linux shell script. Always launch that script from the server directory, and keep the working command documented so an update does not accidentally change memory or file paths.

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

Complete the first launch and EULA step

On its first run, Purpur creates the initial directory structure and configuration files. The process will stop or instruct you to stop until the EULA requirement has been handled. Read the generated EULA file and follow its instructions; do not set acceptance blindly. After completing that step, start the same command again.

Let the second startup finish generating all files before installing plugins or copying a world. Watch the console for a clear completion state and stop the server cleanly from the console rather than closing the terminal window. A clean stop flushes world data and reduces the chance of a damaged save.

Rank #3
New Bee Guitar Cable 10ft Electric Instrument Bass AMP Cord
  • [Low Noise High Fidelity] New bee guitar cord with 22AWG oxygen-free-copper center conductors provides enhanced signal transfer, the PVC insulation material and the high-density stranded copper double shield provide noise rejection for quiet operation
  • [Ideal for Choice] New bee 1/4 straight and right angle metal connectors, ensures a secure connection in any instrument, pedal, or amp jack. L shape great fro on stage guitar stands
  • [Wide Compatible] Suitable for mixer, power amplifier, microphone, effector, decoder, equalizer, electoronic organ, electric guitar, electric bass and other electronic equipments. Widely used in the installation of smart home, karaoke speaker, professional stage audio, etc
  • [Easy Disassemble] Making incidental repairs quick and easy! Very nice, flexible cable
  • [Dont Hesite to Order] 24 hours customer services and professional technology team are standing by

Configure the new server before inviting players

Set basic server properties

Open server.properties with the server stopped when possible. Review the world name and generation settings, difficulty, game mode, player limit, view distance, simulation distance, whitelist behavior, and the server’s bind and port settings. Change only what you understand, then restart and verify the result in the console.

Set operator and access controls

Grant operator status only to trusted accounts. A whitelist is useful when the server should be private: add intended players and keep it enabled before publishing the address. Treat operator access as administrative access, not as a convenience setting for every player.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

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

Review Purpur-specific configuration deliberately

Purpur exposes additional options in its own configuration files. Start with the defaults, change one group of settings at a time, and record every change. If a setting requires a restart, perform a clean stop and start. Avoid /reload as a plugin-lifecycle shortcut; it can leave plugins and server state in an unreliable condition.

Install plugins without breaking the server

Purpur inherits Paper features. Its FAQ also states that Paper, Spigot, and CraftBukkit plugins generally work because those APIs are upstream-compatible. Compatibility is not absolute: a plugin can fail when its author hard-codes checks for a particular implementation or ignores Paper and its forks.

  1. Stop the server cleanly.
  2. Read the plugin’s documentation for the Minecraft and server versions it supports.
  3. Download the plugin JAR from its legitimate project source and place it in the server’s plugins directory.
  4. Start Purpur and inspect the console for dependency errors, version warnings, or stack traces.
  5. Test the plugin’s commands and its effect on a non-critical world before adding more plugins.
  6. Keep a copy of the working configuration so you can remove the newest plugin if a problem appears.

Do not assume that a plugin marked “Spigot” is automatically safe for every Purpur and Minecraft combination. Match the plugin release to the server release and remove incompatible plugins rather than suppressing startup errors.

Test locally before opening network access

First connect from the same computer using the local connection option in the Minecraft client. Confirm that the selected version joins, the world loads, operators and whitelist rules behave as expected, and installed plugins respond correctly. A local test separates server configuration problems from firewall, router, and address problems.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #4
BSIMB 15.6" Digital Family Calendar & Chore Chart, No Subscription Fees
  • Digital Family Calendar: BSIMB digital calendar wall touch screen puts an end to your chaotic life. Designed for busy families, the digital calendar keeps you organised and in step with your family. Assign different colours and tasks to each family member to make family scheduling easier and more intuitive.
  • Easy Setup and Auto-Sync: Plug in, connect to WLAN and auto-syn your electric calendar in minutes. Digital wall calendar compatible with Google calendar, iCloud calendar, Outlook calendar, Cozi calendar and Yahoo calendar. Add events directly on the device or through the ecalendar app. Electronic calendar stays current whether you're at work or traveling—no manual updates needed.
  • All-In-One Home Assistant: Smart calendar builds habits and encourage independence with personalised chores. Display daily meal plan to reduce the daily ‘What's for dinner?’ stress. To-do lists keep track of everything you want. Turning chores into valuable achievements with stars and rewards, making life easier and more enjoyable.
  • Manage Anytime Anywhere: BSIMB electronic calendar for family stay connected with the powerful ecalendar app. Access and manage your digital wall calendar anytime, anywhere with free features like stars & rewards, photo screensaver, chore charts, meals plans, to-do lists etc. Electronic planner paid features like Magic Import tailor advanced tools for users with special needs.
  • Stay in Touch with Loved Ones: Share photos or videos from your phone to electronic wall calendar with app, instantly update your life moment, and keep in touch with your family, especially those who are far away; you can also surprise your smart calendar digital wall by sending him a wish card; it's also great for keeping tech-illiterate elders in touch with the youngsters.

If another device is on the same home network, test with the host computer’s local network address. LAN players use that local address; they do not need your public internet address.

Let friends connect over the internet

What must be configured

Internet access requires more than a running Java process. You need all of the following:

  • The Purpur server must be running and listening on the port configured in server.properties.
  • The host operating system’s firewall must allow inbound traffic for that server port and the Java process.
  • Your router must forward that port to the host computer’s local network address.
  • Players need the correct public address, or a DNS name that resolves to it.

Reserve the host computer’s local address in the router or otherwise keep it stable; a changed local address can silently invalidate the forwarding rule. Make sure the router’s forwarded port and the value in server.properties are identical.

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

Use a private alternative when port forwarding is unsuitable

If you cannot or do not want to expose a router port, a VPN-based virtual LAN is an alternative for a small, trusted group. Everyone joins the same private network and connects using the host’s address on that network. This changes how players reach the server but does not remove the need to run Purpur, manage Java, and maintain backups.

Protect a public server

Keep the whitelist enabled for a private server, grant operator rights sparingly, and avoid sharing administrative files. Review logs after making the server reachable from the internet. Do not expose unrelated services from the host just because one Minecraft port is forwarded.

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

Update Purpur safely

Updating the JAR is a controlled migration, not simply a file replacement. Use this order:

  1. Announce a maintenance window and stop the server cleanly.
  2. Back up every world, server.properties, Purpur and Paper configuration, operator and whitelist files, and the plugins directory.
  3. Record the currently working Minecraft version, Purpur build, Java version, and launch command.
  4. Download the intended build for the intended Minecraft version through the versioned Purpur endpoint.
  5. Keep the old JAR outside the active path, then replace purpur.jar with the downloaded file.
  6. Check every plugin’s compatibility with the new Minecraft and Purpur release before starting.
  7. Start the server and read the entire console output. Stop and restore the backup if worlds fail to load or plugins report blocking errors.
  8. Test locally before allowing players back in.

Never copy a world or configuration into a new version without a backup. A configuration option that worked in one release may be renamed, removed, or interpreted differently in another.

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

Self-hosting versus managed hosting

Purpur itself does not require a particular hosting model. A local machine gives you direct control, while a managed host trades some control for operational convenience. Compare the real responsibilities before choosing:

Consideration Self-hosted Purpur Managed server
Files and JVM flags Full access to the JAR, scripts, Java runtime, and every configuration file. Access depends on the provider’s panel and plan; some JVM options may be restricted.
Cost No hosting subscription, but you supply hardware, electricity, storage, and network service. Recurring hosting charges; the amount depends on the provider, allocated resources, and billing term.
Backups You must design, run, and test backups yourself. A provider may offer backups, but retention, frequency, and restore controls must be checked.
Network exposure You configure the operating-system firewall, router forwarding, and public address. The provider normally supplies an address and network layer, subject to its policies.
Uptime Limited by your machine, power, internet connection, and maintenance. Depends on the provider’s infrastructure and service terms; no universal uptime figure applies.
Player capacity Determined by your CPU, memory, storage, world, plugins, and network. Determined by the allocated plan and provider limits.
Plugin and version support You choose Java, Purpur builds, plugins, and update timing. The panel may simplify installs but can limit versions or require provider-specific workflows.
Upgrades You control backups, JAR replacement, rollback, and testing. One-click tools may exist, but you still need compatibility checks and independent backups.

Troubleshoot the common installation failures

“Unable to access jarfile purpur.jar”

The command is running in the wrong directory, or the file has a different name. List the directory contents, change into the folder that contains the JAR, and make the command’s filename match exactly. Renaming the active file to purpur.jar avoids build-number changes in scripts.

“Unsupported class version” or a Java startup error

The Java runtime is too old or the command is selecting a different installation than the one you checked. Run java -version in the same terminal or script that starts Purpur, then install or select the Java major version required by your Minecraft release.

The server stops because of the EULA

Read the generated EULA file and follow its acceptance instructions, then start the server again. The first run must be allowed to create its files before normal startup can complete.

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.

A plugin fails during startup

Read the first meaningful error in the console, identify the plugin and dependency named there, and compare its supported Minecraft/server versions. Stop the server, remove or update the incompatible plugin, restore the last known-good configuration if necessary, and retest before adding anything else.

Friends cannot connect, but local testing works

Check the server’s configured port, the host firewall rule, the router’s forwarding target, and the public address being shared. Confirm that the host’s local address has not changed. If your network does not permit inbound forwarding, use a private VPN-based network or a managed host instead of repeatedly changing the Purpur configuration.

The world behaves differently after an update

Stop the server and restore the pre-update world and configuration backup. Confirm that the new JAR matches the intended Minecraft version, review Purpur-specific changes, and test again without plugins if necessary. Upgrade one component at a time so the cause remains identifiable.

Installation checklist

  • Target Minecraft version selected and documented.
  • Java version verified with java -version.
  • Matching Purpur build downloaded from the official versioned endpoint.
  • JAR renamed consistently and launched from its own directory.
  • EULA instructions completed and first startup allowed to finish.
  • server.properties, operators, whitelist, and distances reviewed.
  • Local connection tested before any public exposure.
  • Plugin versions checked and console warnings reviewed.
  • World and configuration backups made before every version or plugin change.
  • Firewall, router forwarding, and public address verified only when internet play is required.

With those steps complete, Purpur provides the Paper-compatible server foundation while leaving its additional behavior available for deliberate configuration. The safest routine is simple: match versions, launch from a known directory, test locally, back up before changes, and expose the network only after the server itself is working.

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

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 from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Outdated Drivers Are Slowing You DownFree scan - exact matches

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.