---
title: Geyser Standalone Setup
description: Learn how to set up Geyser Standalone, a standalone Java program that allows you to connect Bedrock players to your Java Edition server.
hide_title: true
---

:::info
You need to have Java 21 or higher installed to run Geyser. To run Geyser Standalone on Android, see the bottom of this page.
:::

:::caution
Geyser-Standalone is NOT a plugin or mod! It is a standalone Java program that you would run separately to your Java Edition server.
:::

#### General Setup & Configuration \{#general-setup--configuration}

1. Download Geyser Standalone from [here](/download).
2. Create a new folder for Geyser, and drop the jar in there.
3. Start Geyser Standalone:
   - **GUI** (Recommended):   
   Double-click the jar file and all the necessary files for Geyser will be created.
   - Or use the **console setup**:   
   Create a new bat or startup script, similar to the one you'd use for a Spigot/Paper server, and take a look at [this](/wiki/geyser/creating-a-startup-script/) page for what to put into it.   
   Run the startup script/bat, and all the necessary files for Geyser will be created.

4. Open your Geyser config (`config.yml`), and find the following:

   ```yaml
   bedrock:
     # The IP address that Geyser will bind on to listen for incoming Bedrock connections.
     # Generally, you should only change this if you want to limit what IPs can connect to your server.
     address: 0.0.0.0

     # The port that will Geyser will listen on for incoming Bedrock connections.
     # Since Minecraft: Bedrock Edition uses UDP, this port must allow UDP traffic.
     port: 19132

   ```
   The `port` is the port Bedrock players will enter to connect to the server.   
   Uncommenting and changing `address` here is only needed if you need to limit connections to a specific IP address.
     

   To configure which Java Edition server Geyser Standalone will send players to, find the remote section:
   ```yaml
   java:
     # The IP address of the Java Edition server.
     address: 127.0.0.1

     # The port of the Java Edition server.
     port: 25565

     # What type of authentication Bedrock players will be checked against when logging into the Java server.
     # Can be "floodgate" (see https://wiki.geysermc.org/floodgate/), "online", or "offline".
     auth-type: online
   ```
   Here, change `address` to the Java server's address, or leave it as-is if the server is on the same machine as Geyser-Standalone.
Then, change `port` to the Java server's port. If you have set up Floodgate on the remote Java server, you can set auth-type to "floodgate" - otherwise, 
set it to either `online` for an online mode server, or `offline` for an offline mode server. To install and set up Floodgate with a Standalone server, see [here](/wiki/floodgate/setup).   
   
5. Connecting to your server
        
   **Connecting locally in the same network**   
   On the same device as the server, you can connect using `localhost`, or `127.0.0.1` as the address.
   Do note: When hosting and playing on the same Windows device, you will need the [loopback fix](/wiki/geyser/fixing-unable-to-connect-to-world#using-geyser-on-the-same-computer).
   Other devices in the same local network can use your local IPv4 to connect - it starts with `10.` or `192.168.`.
   Alternatively, open Minecraft: Bedrock edition, and join the LAN-Server in the **Friends** tab.
        
   **Connecting from a different network**  
   You will need to expose the port Geyser runs on to the Internet if you want players from outside your network to join.
   To achieve that, you have two options:   

    - Port forwarding: Open the Geyser port (e.g. 19132) on the UDP protocol in your router/modem, and in the Windows/Linux firewall.
      After doing this, players can connect with your public IPv4 + port to your server.
      See [here](/wiki/geyser/port-forwarding/) for a helpful guide.   

    - playit.gg: Instead of opening a port (which might not be an option/if you do not want to expose your home ip), you can use
      the playit.gg service to create a tunnel for you to route the traffic through. See our [playit.gg guide](/wiki/geyser/playit-gg).
      Ngrok will not work since it is TCP-only.   

6. Verify whether connections from other networks are possible by running `geyser connectiontest <ip> <port>` in the console.

#### Running Geyser-Standalone on Android \{#running-geyser-standalone-on-android}

:::caution
Applications such as Termux on Android are capable of running Geyser, but this largely depends on how powerful your Android device is. Please do so at your own risk.
:::

##### Termux (Android) \{#termux-android}
1. Download and install [Termux](https://termux.com/)
2. Run `pkg install openjdk-21`
3. Run `wget https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/standalone`
4. Run `java -jar Geyser-Standalone.jar`

OR

We have an automated setup script for clean Termux installs, which might not work for all users. If the manual guide above does not work, try this.
Run this to start the download/install:
```
curl https://gist.githubusercontent.com/rtm516/e3e07d6595ee41e05a38b03c0f4d7a80/raw/install.sh | bash
```

