BedrockServerTermux – Beginner Guide

Run a Minecraft Bedrock Dedicated Server on Android using Termux, Ubuntu, Box64 and playit.gg.

This page shows step-by-step how to host a Minecraft Bedrock server on your Android device using the Termux app, an Ubuntu environment, and the BedrockServerTermux scripts.

Prerequisites

Before starting, make sure you have:

Termux app installed on your Android device (F-Droid version is recommended).
A stable internet connection.
Basic knowledge of simple commands like cd, ls, and copy–paste in Termux.

Tip: If Termux asks for storage permission when you first run it, allow it, then close and reopen Termux once.

Step 1 – Install Ubuntu in Termux

1.1 Open Termux and update packages

Open the Termux app and run these commands one by one:

apt update -y
apt upgrade -y
apt install wget -y

1.2 Download and run the Ubuntu setup script

This will install an Ubuntu environment inside Termux using proot.

wget https://raw.githubusercontent.com/debojitsantra/BedrockServerTermux/refs/heads/main/setup_ubuntu.sh
bash setup_ubuntu.sh

Note: The script may download many packages. This can take some time depending on your internet speed.

1.3 Log in to Ubuntu

After the script finishes, log in to your new Ubuntu system from Termux:

proot-distro login ubuntu

You are now inside Ubuntu running on top of Termux. Commands you run here are separate from the main Android system.

Step 2 – Setup environment & Minecraft Bedrock server

Inside Ubuntu shell

2.1 Update Ubuntu and install wget

Still inside the Ubuntu session, run:

apt update -y
apt upgrade -y
apt install wget -y

2.2 Download and run environment setup script

This script will install required tools (Box64, Playit, Git, etc.) and download/unzip the official Minecraft Bedrock server files.

wget https://raw.githubusercontent.com/debojitsantra/BedrockServerTermux/refs/heads/main/setup_env.sh
bash setup_env.sh

What this does:

Installs needed packages like Box64, Playit, Git.
Downloads the Minecraft Bedrock Dedicated Server and unzips it.
Prepares helper scripts so you can start the server easily.

Step 3 – Run the Minecraft server and playit

3.1 Open two Termux sessions

You need two Termux sessions: one for the Bedrock server and one for the playit tunnel.

Open Termux.
Open the side menu (or long‑press the session tab) and create a new session.

3.2 Log into Ubuntu in both sessions

In each Termux session, run:

proot-distro login ubuntu

3.3 Start the Bedrock server (first session)

In the first Ubuntu session, go to your home directory and run the helper script:

cd
./run

Keep this session open. Once the server fully starts, it will show logs but you can leave it running in the background.

3.4 Start playit tunnel (second session)

In the second Ubuntu session, simply run:

playit

Wait for playit to start. It will show a link that you can open in your browser to configure the tunnel.

Update the Bedrock server

When a new Bedrock server version is available, you can update it easily using the provided script.

4.1 Go to the server directory

Inside Ubuntu (Termux session), run:

cd server

4.2 Download and run the update script

This will download and install the latest version automatically:

wget https://raw.githubusercontent.com/debojitsantra/BedrockServerTermux/refs/heads/main/update.sh
chmod +x update.sh
./update.sh

Tip: If the server is running while you update, stop it first, then run ./run after the update completes.

Step 4 – Connect your server to the world

5.1 Open the playit link

After you start playit in the second session, it will print a link (a URL).

Long‑press to copy the link from Termux.
Open the link in your phone or PC browser.

5.2 Configure playit.gg

On the playit.gg website, follow the steps to connect your local Bedrock server to a public address.

Log in or create a playit.gg account if needed.
Confirm the agent and create a tunnel for Minecraft Bedrock.
Use the address shown on playit.gg in Minecraft to join your server.

How it works: playit.gg forwards traffic from its public address to your local Bedrock server, so friends can join without you doing any router port forwarding.

Tips & troubleshooting

General tips

Make sure you are in the /root (home) directory inside Ubuntu before running ./run.
If a script gives package errors, first run:
```
apt update
```
and then try the script again.
Do not close the Termux sessions running the server or playit while you are playing. Closing them will stop the server.

Common problems

Command not found: Check spelling and make sure you are logged into Ubuntu (proot-distro login ubuntu).
Permission denied when running ./run: make sure the setup scripts completed without errors. If needed, re-run the environment setup step.
Friends cannot join: Confirm that playit is still running and you are using the exact address shown on the playit.gg dashboard.

Battery and heat: Running a Minecraft server plus tunneling on a phone can use a lot of CPU. Keep the phone plugged in and on a cool surface while hosting long sessions.