> ## Documentation Index
> Fetch the complete documentation index at: https://docs.purpify.host/llms.txt
> Use this file to discover all available pages before exploring further.

# Install Java plugins

> Install Minecraft Java plugins with Purpify's one-click installer or upload plugin files manually.

Use Purpify's plugin installer for a one-click installation, or upload plugin files to the `/plugins` folder.

## Before you install a plugin

Confirm that:

* The server uses Java software that supports plugins.
* The plugin supports the server's Minecraft version.
* Every required dependency is installed.
* You created a backup before changing a working server.

## Install with the plugin installer

<Steps>
  <Step title="Open the server">
    Sign in to the [game panel](https://panel.purpify.host) and manage your Java server.
  </Step>

  <Step title="Open the plugin installer">
    Open Purpify's plugin installer from the server management view.
  </Step>

  <Step title="Choose a plugin">
    Search for the plugin, confirm its supported Minecraft versions, and select the release you want.
  </Step>

  <Step title="Install and restart">
    Install the plugin, then restart the server and check the console for dependency or compatibility errors.
  </Step>
</Steps>

## Install a plugin manually

<Steps>
  <Step title="Download the plugin">
    Download the plugin `.jar` from a source you trust. Confirm that the release supports your server software and Minecraft version.
  </Step>

  <Step title="Stop the server">
    Stop the server before changing plugin files.
  </Step>

  <Step title="Upload the plugin">
    Upload the plugin `.jar` to the `/plugins` folder.
  </Step>

  <Step title="Start and verify">
    Start the server and read the console. A successful first start normally creates the plugin's configuration files inside `/plugins`.
  </Step>
</Steps>

## Update or remove a plugin

To update a plugin, stop the server and replace its `.jar` with a compatible newer release. Keep the existing configuration unless the plugin author requires a migration.

To remove a plugin, stop the server and remove its `.jar` from `/plugins`. Keep a backup of its data folder until you confirm the server works without it.

## If the server does not start

Read the first relevant plugin error in the console. Check the plugin version, missing dependencies, and server software before removing other files. Follow [Troubleshoot Java plugin errors](/troubleshooting/plugin-errors) for a symptom-based workflow.
