🎮 Bedrux v1.1.0

Minecraft Bedrock Dedicated Server on Android, Linux & WSL

<br>

🎉 Version 1.1.0 is here! Now with full Linux & WSL support!

</div>

🖥️ Supported Platforms

x86_64 (AMD64)

| | Distro (+WSL) | Support | |:---:|--------|:-------:| | <img src="https://cdn.simpleicons.org/ubuntu" width="20"> | Ubuntu | ✅ | | <img src="https://cdn.simpleicons.org/debian" width="20"> | Debian | ✅ | | <img src="https://cdn.simpleicons.org/fedora" width="20"> | Fedora | ✅ | | <img src="https://cdn.simpleicons.org/android" width="20"> | Termux (PRoot) | ✅ |

aarch64 (ARM64)

| | Distro | Minimum Version | Support | |:---:|--------|:---------------:|:-------:| | <img src="https://cdn.simpleicons.org/ubuntu" width="20"> | Ubuntu | 24.04+ | ✅ | | <img src="https://cdn.simpleicons.org/debian" width="20"> | Debian | 13+ | ✅ | | <img src="https://cdn.simpleicons.org/fedora" width="20"> | Fedora | 41+ | ✅ | | <img src="https://cdn.simpleicons.org/android" width="20"> | Termux (PRoot) | — | ✅ |

[!WARNING] Alpine Linux / postmarketOS not supported!
These distributions use musl instead of glibc, which is incompatible with the Bedrock server and Box64.
Workaround: Use a chroot/proot environment or Docker container with a glibc-based distro. Might need to compile Box64 if it is not in the repos.

✨ What's New in v1.1.0

| Feature | Description | |---------|-------------| | 🐧 Linux/WSL Support | Native support for Ubuntu, Debian, Fedora | | 🔧 ARM64 Linux Support | Box64 auto-installation on supported ARM64 distros | | 🖥️ Modern TUI | Beautiful terminal user interface built with Textual | | 📦 One-Click Install | Download and install any Bedrock server version with a single click | | 💾 Backup & Restore | Create, manage, and restore server backups effortlessly | | 📊 Live Server Stats | Real-time CPU, RAM, and uptime monitoring | | 🎮 Multi-Instance | Run and manage multiple server instances | | ⚡ Auto Architecture Detection | Seamless AMD64/ARM64 support with Box64 integration |

🚀 Features

[x] 🖥️ Stunning Terminal UI — Navigate with ease using the new Bedrux TUI
[x] 📥 Smart Downloads — Fetch latest release, preview, or any specific version
[x] 💾 Backup System — Create and restore server backups with timestamps
[x] 🔄 Instance Management — Create, delete, and switch between server instances
[x] 📊 Real-time Monitoring — Watch CPU, RAM usage, and server uptime live
[x] 🏗️ Multi-Architecture — Native AMD64 + ARM64 (via Box64) support
[x] ⌨️ Interactive Console — Send commands directly to your server
[x] 🎯 Double-Click Actions — Intuitive UI with click-to-start functionality

⚡ Quick Start

[!IMPORTANT] Termux Users: Download Termux from F-Droid (not Play Store version).

[!IMPORTANT] Linux/WSL Users: You may need to run the installer with sudo depending on your system configuration.

1️⃣ Install Bedrux

Open your terminal and run:

curl -sL theonuverse.github.io/bedrux/setup | bash

[!TIP] After installation, you may need to restart your terminal or run source ~/.bashrc for the bedrux command to be available (Linux/WSL only).

2️⃣ Enter Bedrux Environment (Termux only)

pd sh bedrux

3️⃣ Launch Bedrux TUI

bedrux

That's it! 🎉 You're now ready to create and manage your Minecraft Bedrock servers.

🎮 Using Bedrux TUI

Key Actions

| Key | Action | |-----|--------| | S | Start a server instance | | X | Stop the server instance | | Esc | Go back & Quit Bedrux |

Server Console

Once your server is running, you can:

📝 Send commands directly (e.g., say Hello!, stop, op <player>)
📊 Monitor real-time stats (CPU, RAM, uptime)
📜 View live server logs

💡 Important Notes

🔧 ARM64 Compatibility

The Minecraft Bedrock Dedicated Server is built for AMD64 architecture. On ARM64 devices (most Android phones, Raspberry Pi, ARM-based servers), Bedrux automatically uses Box64 for translation.

[!WARNING] Performance varies by device. ARM64 emulation may cause reduced performance compared to native AMD64. For best results, use a device with at least 4GB RAM.

[!WARNING] CPU monitor unavailable on Termux: Termux does not expose per-process CPU usage to unprivileged apps. As a result, Bedrux's live CPU monitor will be unavailable or show inaccurate values when running inside Termux environments. RAM, uptime, logs and server management features still function normally.

🌐 Network Configuration

[!NOTE] Port Forwarding: To allow players outside your local network to connect, you need to forward TCP & UDP port 19132 (default) on your router to your device's local IP address.

[!NOTE] Firewall: On Linux systems, ensure your firewall allows incoming TCP & UDP traffic on port 19132:
sudo ufw allow 19132  # Ubuntu/Debian
sudo firewall-cmd --add-port=19132/tcp --add-port=19132/udp --permanent && sudo firewall-cmd --reload  # Fedora

📂 Data Storage

Bedrux stores all data in ~/.bedrux/:

instances/ — Your server installations
backups/ — Server backups (timestamped .zip files)

🌟 Why Bedrux?

🎯 Simple

One command to install, one command to run. No complex setup required.

🔒 Your Server, Your Rules

Full control over your Minecraft world — no third-party hosting needed.

</td> <td width="50%">

📱 Portable

Run a Bedrock server anywhere your Android phone goes.

💰 Free Forever

No subscriptions, no hidden costs. Open source and community-driven.

</td> </tr> </table>

🛠️ Troubleshooting

<details> <summary><b>Server won't start (Exit code 126)</b></summary>

This usually means the server binary isn't executable. Bedrux v1.0.0 fixes this automatically, but if it persists:

chmod +x ~/.bedrux/instances/<your-server>/bedrock_server

</details> <details> <summary><b>Download fails or times out</b></summary>

Check your internet connection. Bedrux downloads directly from Minecraft's official servers, which may be slow in some regions.

</details> <details> <summary><b>High CPU and RAM usage on ARM64</b></summary>

This is expected due to Box64 translation. Consider reducing view distance and simulation distance in server.properties.

</details>

📚 Additional Resources

❓ Need Help?

For questions, bugs, or feature requests, please open an issue.

I'm here to help! 💜

Made with 💜 by theonuverse

⭐ Star this repo if Bedrux helped you!