# Connecting to a server

<figure><img src="/files/i9mvIJS8d73UMbCWt9h2" alt=""><figcaption></figcaption></figure>

## Joining with Minecraft Java Edition

To connect to a Java Edition Homerun Desktop Minecraft server, first you must download and install [**Minecraft Java Edition.**](https://www.minecraft.net/en-us/download)

{% stepper %}
{% step %}

### Copy the server address

Copy the server address to your clipboard, either through the Homerun Desktop app or by asking a friend. The address will appear similar to **"minecraft.gethomerun.app:12345"**.
{% endstep %}

{% step %}

### Launch Minecraft Java Edition

Launch Minecraft Java Edition through the Minecraft launcher.
{% endstep %}

{% step %}

### Open the Multiplayer menu

From the main Minecraft menu, click the "**Multiplayer"** button to open the Multiplayer menu.

<figure><img src="/files/ehIL775h3Y6NwPzcunso" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Click the Add Server button

In the Multiplayer menu, click the "**Add Server"** button to open the Server Info screen.

<figure><img src="/files/KKvIIPLKarWScvOInCW9" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Enter the server details

Enter a server name into the Server Name field and paste the server address into the Server Address field. Click "**Done"** when the information is accurate.
{% endstep %}

{% step %}

### Join the server

From the Multiplayer menu, select the new server and click the **"Join Server"** button.
{% endstep %}
{% endstepper %}

## Joining with Minecraft Bedrock Edition

To connect to a Bedrock Edition Homerun Desktop Minecraft server, first make sure you have downloaded and installed [**Minecraft Bedrock Edition**](https://minecraft.net/en-us/store/minecraft-java-bedrock-edition-pc).

{% stepper %}
{% step %}

### Locate the server address and port

Locate the server address and port, either through the Homerun Desktop app or by asking a friend. The address will appear similar to **"Address: minecraft.gethomerun.app, Port: 12345"**.
{% endstep %}

{% step %}

### Launch Minecraft Bedrock Edition

Launch Minecraft Bedrock Edition through the Minecraft launcher.
{% endstep %}

{% step %}

### Open the Servers menu

From the main Minecraft menu, click the "**Play" button to open the play menu. From the play menu, click the "Servers" tab to open the servers menu.**

<figure><img src="/files/LmtHeCXZRXTLnhA4eAgK" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Click the Add Server button

From the servers menu, click the "**+ Add Server**" button to open the Add A New Server screen.

<figure><img src="/files/z1AHfh5aasagIcYAqHXE" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Enter the server details

Enter a server name into the Server Name field, enter the server address into the Server Address field, and enter the port into the Port field. Click "**Done"** when the information is accurate.
{% endstep %}

{% step %}

### Join the server

From the Multiplayer menu, select the new server and click the **"Join Server"** button.
{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gethomerun.app/basics/connecting-to-a-server.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
