Skip to content

Setting up on Linux

Pugmatt edited this page Apr 7, 2025 · 12 revisions

The following guide will show you how to get BedrockConnect up and running along with a way to connect to BedrockConnect on console (Through 'Add Friend' method or DNS method)

Install Java

To install Java 8:

Ubuntu: sudo apt install openjdk-8-jre-headless

CentOS: sudo yum install java-1.8.0-openjdk

Download and run BedrockConnect

Download the latest "BedrockConnect-1.0-SNAPSHOT.jar" from: https://github.com/Pugmatt/BedrockConnect/releases

Run: java -jar BedrockConnect-1.0-SNAPSHOT.jar nodb=true

(If this server is made to be accessed outside of the Linux server's network, make sure port 19132 is opened)

Install Connection Method

Next you will need to setup the method of connection to the BedrockConnect instance. Here are two options (Can setup one or both):

'Add Friend' Method (Click to expand)

Download and setup the software MCXboxBroadcast from this repository: https://github.com/MCXboxBroadcast/Broadcaster#Installation

In the generated config.yml, set the target server ip and port to the public IP of your network that's pointing to your running BedrockConnect instance.

Once running, you should be able to connect through the Friends tab ingame as described in the MCXboxBroadcaster install instructions.

DNS Method (Click to expand)

Download the following script: https://raw.githubusercontent.com/Pugmatt/BedrockConnect/master/scripts/install-bind.sh

Run: sudo install-bind.sh [IP]

[BCIP] - Replace with public IP of your network that players will use

(If this server is made to be accessed outside of the Linux server's network, make sure port 53 is also opened)

NOTE: If you are hosting your DNS server to the public, it is highly recommended that recursion on the DNS server stays disabled, in order to mitigate possible DNS amplification attacks. (The install-bind.sh script has recursion disabled by default)

For connecting through the DNS method, you would then set the primary DNS on your devices to the public IP address that you have the server running on, and the secondary DNS to a well-known DNS such as 8.8.8.8