Articles on: Minecraft
This article is also available in:

How to setup a WaterdogPE proxy

WaterDog PE, as the name implies, is bedrock edtion proxy software. For Java Edition, check here

πŸŽ₯ Video Guide πŸŽ₯

πŸ“‘ What you will need πŸ“‘

A server to install the proxy on
2 or more servers to link to the proxy, otherwise it is pointless. These servers can be running any bedrock software, aslong as its compatible with having xbox auth (offline mode), disabled. This is needed for the proxy to work. Don't worry, the proxy will have xbox auth (online mode) turned on.

If you don't have enough servers, consider looking at our multiserver options.

πŸ’­ Terminology πŸ’­

"backend servers" = The servers that are behind your proxy, that are what we want to be able to "fast transfer" between with a command.
"proxy" = The WaterdogPE server.

βž• Creating the proxy βž•

Go to the server that you are going to use for the Waterdog proxy, or create a new one with the Waterdog PE egg (gametype).

Once the server has completed the install, click on the server, to be brought to the panel for it.

You may see that the server has started, we can just click the stop button to stop it for now. At the side bar, go to the File Manager.

Open up the config.yml file. This is where we enter all of the settings for the proxy, such as what servers to have as the backend ones.

In config.yml we are mainly looking for the section called servers, as this is where we enter our backend servers.
This is what it looks like when we first install Waterdog PE:

    address: localhost:19133
    server_type: bedrock

Go to your first backend server, for eg, your lobby, as we will need to get some infomation from it, and change some settings in it.

The first thing that we will need to get is the server IP address and port. We can copy that to our clipboard by clicking on it from the panel's server infomation box.

Then, go to the File Manager on our server, and head over to

In the file, search for xbox-auth.And change it from xbox-auth=on to xbox-auth=off.

Then save the file with the blue button and restart the server to apply the changes. Repeat this for all the servers that you want to add to your proxy.

βœ…Verify you've set it up correctly βœ…

You should have:

Server IP ( (multiple IPs if you are adding them).
Disabled xbox-auth on all of your servers that you want to add to your proxy.
Restarted those servers for that change to take effect.

βš™οΈ Configuring the proxy βš™οΈ

Once you've done all this
, go back to the proxy config.yml file, and to the servers section. We are going to enter your first backend server's infomation.

    server_type: bedrock

If you have a domaim, for example,, then you could put that inpalce of the IP and port in public_address. FOr example

    server_type: bedrock

But as I dont have a domain to demo, the server IP will be just fine there instead. To add multiple servers, simply copy another server section into servers and add the needed info. For example,

    server_type: bedrock
    server_type: bedrock

Another setting that may be useful for you, is priorities (near the top of the file). This setting allows you to provide the name of the server as defined in the servers section, that the proxy should put players on when they join the IP. For example, to make your hub server your first priority, then your survival server as your second priority, set it as

  - hub
  - survival

This will ensure that users attempt to connect to the hub at first, and if the hub isn't online, it will redirect them to the survival server.

Make sure to save the config file. We can now start the proxy, and join it in Minecraft to see if it all works! If you added multiple servers, you can transfer between them with the /server <name> command! Make sure to connect with the proxy IP and port, otherwise the proxy can't do its thing!

If you need any help, feel free to ask in #community-help on the discord, or ask in the live chat!

Updated on: 27/04/2023

Was this article helpful?

Share your feedback


Thank you!