# ![«Image: Minecraft»](images/minecraft-logo.png "Minecraft") Minecraft

For this example, we will host and share a Minecraft server with a contact.

```{raw} html
<div style="position: relative; padding-bottom: calc(56.25% + 1.5rem); height: 0; overflow: hidden; max-width: 100%; margin-bottom: 1.5rem;">
  <iframe
    src="https://www.youtube-nocookie.com/embed/presPB5De6A"
    title="Minecraft custom service configuration demo"
    style="position: absolute; top: 0; left: 0; width: 100%; height: 100%; border: 0;"
    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share"
    referrerpolicy="strict-origin-when-cross-origin"
    allowfullscreen>
  </iframe>
</div>
```

1. Create a dedicated folder on your machine for your Minecraft server. In this example, we will name the folder `MC Server`.
2. Download the official Minecraft server (`server.jar`) from the Minecraft website and move it to the `MC Server` folder.
3. Ensure Java is installed before running the `server.jar` file. On Windows, double-click the `server.jar` file. On Linux and macOS, run the following command in the directory that contains the `server.jar` file:
   `java -Xmx4G -Xms4G -jar server.jar nogui`
4. After running the `server.jar` file, the `MC Server` folder will contain additional files. You need to modify two of these files:
   a. `eula.txt`: Set `eula=true` in this file after reading and agreeing to the EULA.
   b. `server.properties`: Use this file to configure your Minecraft server as required. Check the following property:
      - Set the `server-port` value. You can usually leave this at the default value of `25565` provided that it's not already in use.
5. Save the changes and restart the server using the same method as in Step 3. The server is ready when the console displays the `Done` message.
6. Add a custom service to Jami. Ensure the `Local port` field matches the value you set for `server-port`. As with shared directories and websites, you can control access to the service. After configuring the service, select the **Save** button.

   ```{image} https://jami.net/content/images/2026/06/MC-Server-Setup-1.png
   :alt: An example configuration for sharing the custom Minecraft server on Jami.
   ```

7. Before inviting others, verify that you can connect to the Minecraft server yourself. Inside Minecraft, navigate to **Multiplayer** → **Direct Connection** and enter `server-ip-address:server-port` in the **Server Address** field, then select the **Connect** button.
   If everything is working correctly, you should successfully join the server and see the following message in the server log: `USERNAME joined the game`.
8. Once you've confirmed the server is working correctly, invite your contacts to join.
   - Your contact opens your shared services list and selects your shared Minecraft server.
   - The server address is copied to their clipboard automatically.
   - They paste the address into the `Server Address` field in Minecraft and select **Join Server**.