Skip to content

theonuverse/bedrux

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Bedrux Logo

🎮 Bedrux v1.1.0

Minecraft Bedrock Dedicated Server on Android, Linux & WSL

Version License Platform


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


🖥️ Supported Platforms

x86_64 (AMD64)

Distro (+WSL) Support
Ubuntu
Debian
Fedora
Termux (PRoot)

aarch64 (ARM64)

Distro Minimum Version Support
Ubuntu 24.04+
Debian 13+
Fedora 41+
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

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

Showcase 1 Showcase 2 Showcase 3

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.

📱 Portable

Run a Bedrock server anywhere your Android phone goes.

💰 Free Forever

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


🛠️ Troubleshooting

Server won't start (Exit code 126)

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
Download fails or times out

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

High CPU and RAM usage on ARM64

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


📚 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!