Before you start
Before you install Geyser, please make sure your server is running on a supported platform, such as Paper/Spigot, a supported modded server, a proxy, or a standalone setup.
If your Java server is running an older version than 1.21.11, GeyserMC says you will also need to install ViaVersion.
Geyser uses a Bedrock listener port, which must allow UDP traffic.
Install Geyser
Download the correct Geyser build for your server platform from the Geyser download page.
Upload the file to your server:
For Paper/Spigot or proxy software, place the jar in the
pluginsfolder.For Fabric or NeoForge, place the jar in the
modsfolder.
Restart the server to generate Geyser's files.
Create a Bedrock allocation port
Open your server in the Contol Panel.
In the left sidebar, click Networking.
In the Port Allocations section, click New Allocation to generate an extra port for Bedrock. This will give you a second port alongside your main Java port.
(Optional) Add a note to the new allocation such as
Geyser / Bedrock portso you can recognise it later.Please don't make this new port primary. Leave your original Java port as Primary; Geyser will listen only on the new Bedrock port.
Configure the Bedrock port
Open Geyser's config file and locate the bedrock: section.
Common config paths include:
/plugins/Geyser-Spigot/config.ymlfor Paper/Spigot./config/Geyser-Fabric/config.ymlor/config/Geyser-NeoForge/config.ymlfor modded servers./plugins/Geyser-xyz/config.ymlfor proxy setups.
Update these settings as needed:
bedrock:
address: 0.0.0.0
port: 19132 (Insert the port that you've created in previous step)
clone-remote-port: false
portis the Bedrock port that players will use to connect.clone-remote-portshould stay disabled unless your hosting setup specifically requires the Bedrock port to match the Java port.addressusually stays as0.0.0.0unless you need to limit which IPs can connect.
Important: Geyser cannot share the same UDP port with other services such as voice chat or query plugins.
Save the file, then restart the server again.
Optional: allow Bedrock login with Floodgate
If you want Bedrock players to join without owning a Java Edition account, install Floodgate and change Geyser's auth-type to floodgate.
Basic Floodgate setup:
Download the correct Floodgate build for your platform.
Upload it to the
pluginsormodsfolder, depending on your server type.Restart the server.
Change
auth-typein the Geyser config tofloodgate.Restart the server again.
If you are using Geyser Standalone or ViaProxy with Floodgate, you must also copy the key.pem file from Floodgate to the location required by Geyser.
Important: Never share the key.pem file with anyone.
Test the connection
After setup, test Bedrock connectivity with the console command below:
geyser connectiontest <ip> <port>
If your server is self-hosted and players are joining from outside your local network, you must expose the Geyser Bedrock port over UDP by using port forwarding or a supported tunneling service such as playit.gg.
GeyserMC also notes that ngrok will not work for this use case because it is TCP-only.
Connect from Bedrock
Bedrock players can join using your server's public IP address and the configured Bedrock port.
Troubleshooting
Server version too old: install ViaVersion if your Java server is older than 1.21.11.
Bedrock login issues: verify
auth-typeis set correctly, especially if you installed Floodgate.Plugin conflicts: make sure Geyser is not sharing the same UDP port with voice chat or query services.
Modded setup issues: Geyser only supports server-side mods; mods that require client-side installation will not work through Geyser.