Skip to main content
All CollectionsModrinth Servers
Adding Geyser to your server
Adding Geyser to your server

How do I add Geyser to my Modrinth server?

Emma Alexia avatar
Written by Emma Alexia
Updated this week

Geyser is a plugin which allows Bedrock clients to join your Java server. This guide walks you through setting it up on your Modrinth server.


Getting started

In order to get Geyser working, you'll need to have:

  • The latest version of Geyser installed on your version of Minecraft

  • A mod or plugin loader setup on your server

If you're currently using vanilla Minecraft, you can switch to a compatible platform by going into Options -> Platform on the server panel. If you're unsure which platform to use, Fabric is a good choice, and won't change vanilla Minecraft by default.

Installing Geyser onto your server

⚠️ ​Ensure your server is offline and keep it offline for the duration of this guide.

  1. On your server's dashboard, click the Content tab

  2. Click Add mod or Add plugin

  3. Search for 'geyser' and click Install

Creating a new allocation

For Bedrock players to connect, you'll need to create a new allocation:

  1. On your server's dashboard, navigate to Options -> Network, and scroll down to Allocations

  2. Click 'New allocation' and name it whatever you'd like, then click 'Create allocation'

  3. Once created, find and remember the allocation's port number (e.g. 26024)

Configuring Geyser

We now need to configure Geyser to use the new allocation we just created:

  1. Start then stop your server to generate the configuration

  2. Navigate to the Files tab, then to the 'plugins' folder if you're using Paper or Purpur, or to the 'config' folder if you're using Fabric, Quilt, NeoForge, or Forge

  3. Click into the Geyser-<loader> folder, then click the config.yml file to open the configuration

  4. Find the line, close to the top of the file, that starts with port:

    Replace the number that follows with the port number of the allocation you previously created. In my case, the new allocation's port number was 26024, meaning the edited line would be port=26024

  5. Save the configuration by clicking the Save icon, then selecting Save

Ensuring Geyser is configured

  1. Navigate to the Overview tab, then start the server

  2. Once it's finished starting, you should see a line at the bottom of the console saying something similar to Started Geyser on UDP port 26024:


    As long as the line contains your previously created allocation's port number, Geyser is installed and configured correctly! Join the server and you should see it working. 😄

    If the port number is incorrect, stop your server and retry the 'Configuring Geyser' section of this guide.

Did this answer your question?