> ## 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.

# Connect to a Java server

> Add a Purpify Minecraft Java Edition server in Multiplayer using its address or an optional subdomain.

Copy the connection address from the Purpify game panel, then add it in the Minecraft Java Edition **Multiplayer** menu.

## Before you connect

Confirm that:

* The server status is running.
* Your Minecraft client uses a version supported by the server.
* You installed any mods required by the server.
* You are on the allowlist when the server uses one.

## Add the server

<Steps>
  <Step title="Copy the address">
    Sign in at [panel.purpify.host](https://panel.purpify.host), open the server, and copy its connection address.

    If the panel shows the address and port separately, enter them together as `address:port`.
  </Step>

  <Step title="Open Multiplayer">
    In Minecraft Java Edition, select **Multiplayer** > **Add Server**.
  </Step>

  <Step title="Enter the server details">
    Enter any name in **Server Name**. Paste the Purpify connection address into **Server Address**.
  </Step>

  <Step title="Save and join">
    Select **Done**, choose the server from the list, and select **Join Server**.
  </Step>
</Steps>

<Check>
  The connection works when the server opens and you reach its world or configured login area.
</Check>

## Add an optional subdomain

A subdomain gives players a named address they can use instead of the default server address.

<Steps>
  <Step title="Open Network">
    Manage the server in the Purpify game panel and go to **Network**.
  </Step>

  <Step title="Add a subdomain">
    Add a subdomain for the server and choose the available name you want.
  </Step>

  <Step title="Copy the subdomain">
    Copy the complete subdomain shown in **Network**.
  </Step>

  <Step title="Use it in Minecraft">
    Paste the subdomain into Minecraft's **Server Address** field, save the entry, and join.
  </Step>
</Steps>

## Fix connection problems

<AccordionGroup>
  <Accordion title="The server appears offline">
    Confirm that the Purpify panel shows the server as running. Copy the address again and check that the port is present when required.
  </Accordion>

  <Accordion title="Incompatible client error">
    Open **Versions** in the Purpify panel and check the server's Minecraft version. Launch a compatible Java client version.
  </Accordion>

  <Accordion title="Missing mods or rejected mod list">
    Install the same required mod loader, mod versions, and dependencies used by the server.
  </Accordion>

  <Accordion title="You are not whitelisted">
    Add the player's exact, case-sensitive Java username to the whitelist. Follow [Manage Java players](/java/manage-players) for the console commands and access warning.
  </Accordion>

  <Accordion title="The subdomain does not work">
    Copy the subdomain again from **Network** and test the default Purpify address. If the default address works, check the subdomain configuration in the panel.
  </Accordion>
</AccordionGroup>