Geyser Not Working? Fixes for Bedrock Players Who Can't Connect
Most Geyser problems come down to the port, a version mismatch, or the login method. The rest are one-line config fixes that are easy to miss.
This page follows GeyserMC's published common-issues list, checked November 21, 2026. We've tried to keep to what the page actually says. If you haven't installed Geyser yet, start with the setup guide.
On this page
Start with the console
Before you change anything, open the Console tab and restart the server. Read from the top. Geyser prints its own startup lines, and an error there tells you more than a player's "unable to connect" screen does. Config edits happen in plugins/Geyser-Spigot/config.yml on the Files tab, and every change needs a restart.
Player-side problems
| What the player sees | What GeyserMC says to try |
|---|---|
| Server isn't in the friends list | Add it by hand in the Servers list on Windows, iOS or Android. Consoles use a different method, described on Geyser's consoles page. |
| "Invalid IP address!" | Use the IPv4 address, not a domain that resolves through an SRV record. Don't type the IP and the port together in the address box. |
| Stuck on "Locating Server" | Update Java. On a weak network, lower advanced.bedrock.mtu in steps of 100 and retest each time. |
| "Unable to Connect to World" and nothing in the console | Geyser keeps a separate page for this one. Search for it by that name. |
| Game freezes the first time a command is used | Turn off command-suggestions in the Geyser config. Command whitelist or hide-commands tools are the other option. |
Version mismatch messages
- "Outdated client! Please use 1.x.x" means the server is too new for your Geyser, or Geyser is out of date. Update Geyser.
- "Outdated server! I'm still on 1.x.x" means the Bedrock player is newer than the Java server. Update the server, or add ViaVersion.
- A class file version 65.0 error means Java is too old. Geyser's page says to update to Java 21. On ChicagoServers the Java runtime is managed for you, so contact support if you see this.
Login and authentication errors
- "Cannot reply to EncryptionRequestPacket". If you copied the Floodgate key into Geyser's own folder on the same server, delete that copy and restart. Also check that Geyser and the Java server agree on online or offline mode. If the server is online-mode, Geyser has to match, with valid credentials.
- "Connection Refused". Check that the address and port in the config are right, the server is actually running, and the port is open. A proxy or anti-DDoS filter placed in front of the server can cause this too.
- "Missing profile key. This server requires secure profiles." Geyser has a separate secure chat page for it.
- Using a proxy? Install Floodgate on every backend server and give them the same
key.pemandconfig.yml. The Floodgate guide has the steps.
If Mojang account logins give you trouble, GeyserMC's advice for servers is to use Floodgate, because it takes Java account credentials out of the picture for Bedrock players.
Port and startup errors
- "java.net.BindException: Address already in use". Something else already owns the port, often a second Geyser instance. Close it. Restarting the server often clears it.
- Reverse proxy not in use. If you don't run one, set
advanced.java.use-haproxy-protocoltofalse. - Locale asset cache download fails. Geyser's page suggests starting with
-Djava.net.preferIPv4Stack=true. Launch options are staff-only on our panel, so ask support. - Host won't open UDP for a standalone Geyser. Geyser describes a workaround that depends on your host's setup, so ask your host before trying it.
Still stuck
Write down the exact message the player sees, the version of Minecraft they're on, and the last few lines from the Console tab. Then check the general connection guide for port and firewall basics, and contact support if the port needs opening.
Frequently asked questions
Why does Geyser say Invalid IP address?
Use the IPv4 address instead of a domain that resolves through an SRV record, and don't type the port in the address box.
What does Outdated client mean in Geyser?
The server is too new for your Geyser version, or Geyser is outdated. Update Geyser.
Why do Bedrock players freeze when they first use a command?
Geyser's page says to disable <code>command-suggestions</code> in the config, or use a command whitelist or hide-commands tool.
What is a BindException on Geyser?
Another program, often a second Geyser instance, is already using the port. Close it and restart.
Can Geyser break after a Minecraft update?
It can. Geyser has to catch up with each new version, so update Geyser when you update the server.