We are your new 5-Star Hosting Company. At least according to ★ Trustpilot

Following along with a Minecraft server? Deploy yours in minutes.

All servers come with a 24-Hour Trial, Free Backups, and 40Gbps DDoS Protection included!

Use code SAVE15 to take 15% OFF Your First Invoice with ChicagoServers! Limited Time!
Minecraft guide

Geyser Not Working? Fixes for Bedrock Players Who Can't Connect

By the ChicagoServers team · Updated · 6 min read

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.

Quick answer
    On this page
    1. Start with the console
    2. Player-side problems
    3. Version mismatch messages
    4. Login and authentication errors
    5. Port and startup errors
    6. Still stuck
    7. Frequently asked questions

    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 seesWhat GeyserMC says to try
    Server isn't in the friends listAdd 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 consoleGeyser keeps a separate page for this one. Search for it by that name.
    Game freezes the first time a command is usedTurn 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.pem and config.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-protocol to false.
    • 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.

    We are your new 5-Star Hosting Company. At least according to ★ Trustpilot

    Following along with a Minecraft server? Deploy yours in minutes.

    All servers come with a 24-Hour Trial, Free Backups, and 40Gbps DDoS Protection included!

    We offer quality support, a detailed knowledgebase, video tutorials on most topics, and even live support in case you prefer a live human.

    Use code SAVE15 to take 15% OFF Your First Invoice with ChicagoServers! Limited Time!