How To Fix "Status Code 504" Error?

A Status Code 504 (Gateway Timeout) error in Minecraft means your game or server is waiting too long for a response from an external server - usually Mojang's authentication servers, a proxy, or a Realms service. It does not mean something is wrong with your game files.

This guide covers the most common causes and how to resolve each one.

Method 1: Check Mojang's Server Status

The 504 error is often caused by Mojang's servers being slow or temporarily unavailable.

1. Open your browser and visit the Downdetector for Minecraft website.
2. Look for any reported outages or degraded services.
3. If an outage is confirmed, wait 15-30 minutes and try again.

Method 2: Restart Your Network Connection

A dropped or unstable connection can trigger a timeout before Mojang's servers respond.

1. Close Minecraft completely.
2. Unplug your router and modem, wait 30 seconds, then plug them back in.
3. Wait for your connection to fully restore, then relaunch Minecraft and try again.

Method 3: Disable Your VPN or Proxy

VPNs and proxies can reroute traffic in a way that causes authentication requests to time out.

1. Open your VPN or proxy application.
2. Disconnect or disable it entirely.
3. Relaunch Minecraft and attempt to log in or connect again.

Method 4: Check Your Firewall and Antivirus

Security software can block outbound connections Minecraft needs for authentication.

1. Open your firewall or antivirus application.
2. Add Minecraft (and your launcher, if using a third-party one) to the list of allowed applications.
3. Confirm that port 443 (HTTPS) is not being blocked for Minecraft's traffic.
4. Relaunch Minecraft and test again.

Method 5: Update Minecraft

Outdated game versions can cause authentication failures, including 504 errors.

1. Open your Minecraft launcher.
2. Check for any available updates and install them.
3. Relaunch the updated version and attempt to connect.

Method 6: Clear the Game Cache (Mobile Only)

On mobile devices, a corrupted cache can interfere with authentication requests.

1. Open your device's Settings and go to Apps (or Application Manager).
2. Find Minecraft in the list and tap it.
3. Tap Storage, then tap Clear Cache.
4. Relaunch Minecraft and sign in again.

Method 7: Reduce World File Count (Realms Upload Only)

If you are seeing a 504 error when uploading a world to Realms, the issue is likely too many individual files in your world folder - not the total file size.

1. Locate your world save folder on your computer.
2. Open the data subfolder inside your world directory.
3. Delete excess map_*.dat files. These accumulate over time and are safe to remove if the maps are no longer needed.
4. Check the stats folder as well, and remove files for players who no longer join your world.
5. Try the Realms upload again.