Setup
- Host Provider
- Self Host
Paper / Spigot Fabric
NeoForge
Velocity BungeeCord
ViaProxy
Standalone
Checking your server version
If your server is not running 26.3, you will need to install ViaVersion. For more information, see Supported versions.
Installing Geyser
- Download
Geyser-Spigot.jar. - Place the
Geyser-Spigot.jarin thepluginsfolder. - Restart the server.
- Download
Configuring Geyser
Now open the file
/plugins/Geyser-Spigot/config.yml. Find the part that starts withbedrock:, and change the lines shown below.NetherNet is supported fully by 26.50+. Connecting will still work on 26.40+.
/plugins/Geyser-Spigot/config.ymlbedrock:port: 19132transport: nethernetRestart the server.
Since you are self-hosting, you can choose the port freely; the default is 19132. Geyser uses it over both TCP and UDP, so it cannot be the port of the Paper / Spigot server.
Important: No other program can use the Geyser port, over either protocol. This includes programs that use UDP, such as voice chat mods or Query, and programs that use TCP, such as another server, a web map, or a website.
Connecting on Bedrock
Connecting from the same network
On the same device as the server, connect withlocalhostor127.0.0.1as the address. Other devices in the same local network can use your local IPv4 address, which starts with10.or192.168..Connecting from a different network
To let players from outside your network join, you need to make the Geyser port reachable from the internet.cautionThe Geyser port has to be forwarded for both TCP and UDP. Before NetherNet, forwarding UDP was enough. Now, players use TCP to find your server and UDP to play on it, so without TCP your server will not show up.You have two options:
- Port forwarding: open the Geyser port (e.g. 19132) for both TCP and UDP in your router and in your firewall. Players then connect with your public IPv4 address and the port. For detailed steps, see Port forwarding.
- playit.gg: if you cannot open a port, or do not want to expose your home IP address, playit.gg can create a tunnel for you. See playit.gg Setup. Ngrok does not work, since it does not support UDP.
Recommended: Set up HTTPS for signaling
Geyser's built-in signaling server uses plain HTTP by default, so Minecraft shows players a "Trust on First Use?" prompt the first time they join. To avoid this prompt, serve signaling over HTTPS, as explained in HTTPS for NetherNet. Some external signaling services, such as Warden, provide HTTPS as well.
Installing Geyser
- Download
Geyser-Fabric.jar. - Place the
Geyser-Fabric.jarin themodsfolder. - If it is not installed already, download Fabric API and place it in the same folder.
- Restart the server.
- Download
Configuring Geyser
Now open the file
/config/Geyser-Fabric/config.yml. Find the part that starts withbedrock:, and change the lines shown below.NetherNet is supported fully by 26.50+. Connecting will still work on 26.40+.
/config/Geyser-Fabric/config.ymlbedrock:port: 19132transport: nethernetRestart the server.
Since you are self-hosting, you can choose the port freely; the default is 19132. Geyser uses it over both TCP and UDP, so it cannot be the port of the Fabric server.
Important: No other program can use the Geyser port, over either protocol. This includes programs that use UDP, such as voice chat mods or Query, and programs that use TCP, such as another server, a web map, or a website.
Connecting on Bedrock
Connecting from the same network
On the same device as the server, connect withlocalhostor127.0.0.1as the address. Other devices in the same local network can use your local IPv4 address, which starts with10.or192.168..Connecting from a different network
To let players from outside your network join, you need to make the Geyser port reachable from the internet.cautionThe Geyser port has to be forwarded for both TCP and UDP. Before NetherNet, forwarding UDP was enough. Now, players use TCP to find your server and UDP to play on it, so without TCP your server will not show up.You have two options:
- Port forwarding: open the Geyser port (e.g. 19132) for both TCP and UDP in your router and in your firewall. Players then connect with your public IPv4 address and the port. For detailed steps, see Port forwarding.
- playit.gg: if you cannot open a port, or do not want to expose your home IP address, playit.gg can create a tunnel for you. See playit.gg Setup. Ngrok does not work, since it does not support UDP.
Recommended: Set up HTTPS for signaling
Geyser's built-in signaling server uses plain HTTP by default, so Minecraft shows players a "Trust on First Use?" prompt the first time they join. To avoid this prompt, serve signaling over HTTPS, as explained in HTTPS for NetherNet. Some external signaling services, such as Warden, provide HTTPS as well.
Installing Geyser
- Download
Geyser-NeoForge.jar. - Place the
Geyser-NeoForge.jarin themodsfolder. - Restart the server.
- Download
Configuring Geyser
Now open the file
/config/Geyser-NeoForge/config.yml. Find the part that starts withbedrock:, and change the lines shown below.NetherNet is supported fully by 26.50+. Connecting will still work on 26.40+.
/config/Geyser-NeoForge/config.ymlbedrock:port: 19132transport: nethernetRestart the server.
Since you are self-hosting, you can choose the port freely; the default is 19132. Geyser uses it over both TCP and UDP, so it cannot be the port of the NeoForge server.
Important: No other program can use the Geyser port, over either protocol. This includes programs that use UDP, such as voice chat mods or Query, and programs that use TCP, such as another server, a web map, or a website.
Connecting on Bedrock
Connecting from the same network
On the same device as the server, connect withlocalhostor127.0.0.1as the address. Other devices in the same local network can use your local IPv4 address, which starts with10.or192.168..Connecting from a different network
To let players from outside your network join, you need to make the Geyser port reachable from the internet.cautionThe Geyser port has to be forwarded for both TCP and UDP. Before NetherNet, forwarding UDP was enough. Now, players use TCP to find your server and UDP to play on it, so without TCP your server will not show up.You have two options:
- Port forwarding: open the Geyser port (e.g. 19132) for both TCP and UDP in your router and in your firewall. Players then connect with your public IPv4 address and the port. For detailed steps, see Port forwarding.
- playit.gg: if you cannot open a port, or do not want to expose your home IP address, playit.gg can create a tunnel for you. See playit.gg Setup. Ngrok does not work, since it does not support UDP.
Recommended: Set up HTTPS for signaling
Geyser's built-in signaling server uses plain HTTP by default, so Minecraft shows players a "Trust on First Use?" prompt the first time they join. To avoid this prompt, serve signaling over HTTPS, as explained in HTTPS for NetherNet. Some external signaling services, such as Warden, provide HTTPS as well.
Checking your server version
All servers on the network must accept 26.3 Java clients, as Geyser imitates one.
Installing Geyser
- Download
Geyser-Velocity.jar. - Place the
Geyser-Velocity.jarin thepluginsfolder. - Restart Velocity.
- Download
Configuring Geyser
Now open the file
/plugins/Geyser-Velocity/config.yml. Find the part that starts withbedrock:, and change the lines shown below.NetherNet is supported fully by 26.50+. Connecting will still work on 26.40+.
/plugins/Geyser-Velocity/config.ymlbedrock:port: 19132transport: nethernetRestart the server.
Since you are self-hosting, you can choose the port freely; the default is 19132. Geyser uses it over both TCP and UDP, so it cannot be the port of the Velocity server.
Important: No other program can use the Geyser port, over either protocol. This includes programs that use UDP, such as voice chat mods or Query, and programs that use TCP, such as another server, a web map, or a website.
Connecting on Bedrock
Connecting from the same network
On the same device as the server, connect withlocalhostor127.0.0.1as the address. Other devices in the same local network can use your local IPv4 address, which starts with10.or192.168..Connecting from a different network
To let players from outside your network join, you need to make the Geyser port reachable from the internet.cautionThe Geyser port has to be forwarded for both TCP and UDP. Before NetherNet, forwarding UDP was enough. Now, players use TCP to find your server and UDP to play on it, so without TCP your server will not show up.You have two options:
- Port forwarding: open the Geyser port (e.g. 19132) for both TCP and UDP in your router and in your firewall. Players then connect with your public IPv4 address and the port. For detailed steps, see Port forwarding.
- playit.gg: if you cannot open a port, or do not want to expose your home IP address, playit.gg can create a tunnel for you. See playit.gg Setup. Ngrok does not work, since it does not support UDP.
Recommended: Set up HTTPS for signaling
Geyser's built-in signaling server uses plain HTTP by default, so Minecraft shows players a "Trust on First Use?" prompt the first time they join. To avoid this prompt, serve signaling over HTTPS, as explained in HTTPS for NetherNet. Some external signaling services, such as Warden, provide HTTPS as well.
Checking your server version
All servers on the network must accept 26.3 Java clients, as Geyser imitates one.
Installing Geyser
- Download
Geyser-BungeeCord.jar. - Place the
Geyser-BungeeCord.jarin thepluginsfolder. - Restart BungeeCord.
- Download
Configuring Geyser
Now open the file
/plugins/Geyser-BungeeCord/config.yml. Find the part that starts withbedrock:, and change the lines shown below.NetherNet is supported fully by 26.50+. Connecting will still work on 26.40+.
/plugins/Geyser-BungeeCord/config.ymlbedrock:port: 19132transport: nethernetRestart the server.
Since you are self-hosting, you can choose the port freely; the default is 19132. Geyser uses it over both TCP and UDP, so it cannot be the port of the BungeeCord server.
Important: No other program can use the Geyser port, over either protocol. This includes programs that use UDP, such as voice chat mods or Query, and programs that use TCP, such as another server, a web map, or a website.
Connecting on Bedrock
Connecting from the same network
On the same device as the server, connect withlocalhostor127.0.0.1as the address. Other devices in the same local network can use your local IPv4 address, which starts with10.or192.168..Connecting from a different network
To let players from outside your network join, you need to make the Geyser port reachable from the internet.cautionThe Geyser port has to be forwarded for both TCP and UDP. Before NetherNet, forwarding UDP was enough. Now, players use TCP to find your server and UDP to play on it, so without TCP your server will not show up.You have two options:
- Port forwarding: open the Geyser port (e.g. 19132) for both TCP and UDP in your router and in your firewall. Players then connect with your public IPv4 address and the port. For detailed steps, see Port forwarding.
- playit.gg: if you cannot open a port, or do not want to expose your home IP address, playit.gg can create a tunnel for you. See playit.gg Setup. Ngrok does not work, since it does not support UDP.
Recommended: Set up HTTPS for signaling
Geyser's built-in signaling server uses plain HTTP by default, so Minecraft shows players a "Trust on First Use?" prompt the first time they join. To avoid this prompt, serve signaling over HTTPS, as explained in HTTPS for NetherNet. Some external signaling services, such as Warden, provide HTTPS as well.
plugins or mods folder. To run Geyser as a plugin or mod on your server instead, pick your server software in the tabs above.Installing Geyser
- Set up ViaProxy.
- Download
Geyser-ViaProxy.jar. - Place the
Geyser-ViaProxy.jarin thepluginsfolder. - Restart ViaProxy.
Configuring Geyser
Now open the file
/plugins/Geyser/config.yml. Find the part that starts withbedrock:, and change the lines shown below.NetherNet is supported fully by 26.50+. Connecting will still work on 26.40+.
/plugins/Geyser/config.ymlbedrock:port: 19132transport: nethernetRestart the server.
Since you are self-hosting, you can choose the port freely; the default is 19132. Geyser uses it over both TCP and UDP, so it cannot be the port of the ViaProxy server.
Important: No other program can use the Geyser port, over either protocol. This includes programs that use UDP, such as voice chat mods or Query, and programs that use TCP, such as another server, a web map, or a website.
If you use the ViaProxy GUI, you can use its account management to join online mode servers with Bedrock Edition. If you use the ViaProxy CLI and want Bedrock players to join your online mode server, install and set up Floodgate.
ViaProxy manages the
auth-typesetting itself, so its value in the config is ignored.Connecting on Bedrock
Connecting from the same network
On the same device as the server, connect withlocalhostor127.0.0.1as the address. Other devices in the same local network can use your local IPv4 address, which starts with10.or192.168..Connecting from a different network
To let players from outside your network join, you need to make the Geyser port reachable from the internet.cautionThe Geyser port has to be forwarded for both TCP and UDP. Before NetherNet, forwarding UDP was enough. Now, players use TCP to find your server and UDP to play on it, so without TCP your server will not show up.You have two options:
- Port forwarding: open the Geyser port (e.g. 19132) for both TCP and UDP in your router and in your firewall. Players then connect with your public IPv4 address and the port. For detailed steps, see Port forwarding.
- playit.gg: if you cannot open a port, or do not want to expose your home IP address, playit.gg can create a tunnel for you. See playit.gg Setup. Ngrok does not work, since it does not support UDP.
Recommended: Set up HTTPS for signaling
Geyser's built-in signaling server uses plain HTTP by default, so Minecraft shows players a "Trust on First Use?" prompt the first time they join. To avoid this prompt, serve signaling over HTTPS, as explained in HTTPS for NetherNet. Some external signaling services, such as Warden, provide HTTPS as well.
Installing Geyser
- Download Geyser Standalone.
- Create a new folder for Geyser, and put the jar in it.
- Start Geyser Standalone:
Configuring Geyser
Now open the file
config.yml. Find the part that starts withbedrock:, and change the lines shown below.NetherNet is supported fully by 26.50+. Connecting will still work on 26.40+.
config.ymlbedrock:port: 19132transport: nethernetRestart Geyser.
Since you are self-hosting, you can choose the port freely; the default is 19132. Geyser uses it over both TCP and UDP.
Important: No other program can use the Geyser port, over either protocol. This includes programs that use UDP, such as voice chat mods or Query, and programs that use TCP, such as another server, a web map, or a website.
To choose which Java Edition server Geyser Standalone sends players to, find the
javasection: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: onlineChange
addressto the Java server's address, or leave it as it is if the server runs on the same machine as Geyser. Then changeportto the Java server's port. Setauth-typetofloodgateif you set up Floodgate on the Java server, otherwise toonlinefor an online mode server orofflinefor an offline mode server. To use Floodgate with Geyser Standalone, see Floodgate Setup.Connecting on Bedrock
Connecting from the same network
On the same device as the server, connect withlocalhostor127.0.0.1as the address. Other devices in the same local network can use your local IPv4 address, which starts with10.or192.168.. Alternatively, open Minecraft: Bedrock Edition and join the LAN server in the Friends tab.Connecting from a different network
To let players from outside your network join, you need to make the Geyser port reachable from the internet.cautionThe Geyser port has to be forwarded for both TCP and UDP. Before NetherNet, forwarding UDP was enough. Now, players use TCP to find your server and UDP to play on it, so without TCP your server will not show up.You have two options:
- Port forwarding: open the Geyser port (e.g. 19132) for both TCP and UDP in your router and in your firewall. Players then connect with your public IPv4 address and the port. For detailed steps, see Port forwarding.
- playit.gg: if you cannot open a port, or do not want to expose your home IP address, playit.gg can create a tunnel for you. See playit.gg Setup. Ngrok does not work, since it does not support UDP.
Recommended: Set up HTTPS for signaling
Geyser's built-in signaling server uses plain HTTP by default, so Minecraft shows players a "Trust on First Use?" prompt the first time they join. To avoid this prompt, serve signaling over HTTPS, as explained in HTTPS for NetherNet. Some external signaling services, such as Warden, provide HTTPS as well.
Running Geyser Standalone on Android
- Download and install Termux.
- Run
pkg install openjdk-21. - Run
wget -O Geyser-Standalone.jar https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/standalone. - Run
java -jar Geyser-Standalone.jar.
Alternatively, there is an automated setup script for clean Termux installs. It might not work for everyone, so try it if the steps above do not work:
curl https://gist.githubusercontent.com/rtm516/e3e07d6595ee41e05a38b03c0f4d7a80/raw/install.sh | bash