Browser-Based Minecraft at Home: Offline EaglercraftX with Docker

Minecraft multiplayer at home — no accounts, no native client, just a browser.

EaglercraftX is an open-source browser port of Minecraft 1.8.8. This project packages it into a Docker container so players can join from any device on your local network using Chrome or Firefox.

Why not just use a public Eaglercraft server?

#

Public Eaglercraft servers are free and easy to find — but they come with risks that parents should understand. When your child connects to someone else’s server, the server operator controls the web client code running in the browser. Unlike official Minecraft from the Microsoft Store, there’s no app store vetting.

What can go wrong on public servers:

• Aggressive ads and popups — many public servers monetize through intrusive ads and fake “download” buttons that kids click without thinking
• Malicious redirects — the served JavaScript can redirect to phishing pages or fake “Your computer is infected” scareware that tricks kids into downloading actual malware
• Credential phishing — fake login forms that harvest email/passwords kids might reuse on other sites
• Background crypto mining — browser-based mining scripts running silently while the kid plays

Self-hosting greatly reduces these risks: you control the client code, there are no third-party scripts, no ads, and no external network traffic. Combined with LAN-only access (or VPN for remote play), your attack surface drops to near zero.

Why this setup works for families

#

• Browser-based client — no native launcher install on any device
• Local multiplayer on your home network
• Simple Docker lifecycle (up, down, logs)
• Persistent worlds and logs in ./data
• Optional admin dashboard for server visibility

What you get

#

• Game/browser endpoint: http://YOUR_SERVER_IP:8081
• Admin dashboard endpoint: http://YOUR_SERVER_IP:8082
• Included plugins:
  • Plan Player Analytics
  • Vault
  • LuckPerms
  • EssentialsX (+ Chat + Spawn)
  • WorldEdit
  • WorldGuard

Prerequisites

#

• Docker and git installed
• 4 GB+ free RAM
• Free ports: 8081 (game) and 8082 (dashboard)

sudo apt-get update
sudo apt-get install -y docker.io docker-compose docker-buildx git
sudo usermod -aG docker $USER
# Log out and back in for the group change to take effect

sudo pacman -S docker docker-compose docker-buildx git
sudo systemctl enable --now docker
sudo usermod -aG docker $USER
# Log out and back in for the group change to take effect

5-step setup

#

1) Clone the repository

#

git clone https://github.com/hackboxguy/eaglercraft-docker.git
cd eaglercraft-docker

2) Build the Docker image

#

docker build -t eaglercraftx-server:local .

This downloads and assembles all server components. It takes 5–15 minutes depending on your internet speed. You’ll see a lot of output — that’s normal. When it’s done, you should see:

Successfully tagged eaglercraftx-server:local

3) Start the stack

#

docker compose up -d

4) Watch startup logs

#

docker compose logs -f eaglercraft

Wait for:

All services started successfully!
Open in browser: http://<IP>:8081

5) Join from browser

#

• On host machine: http://localhost:8081
• On other home devices: http://YOUR_SERVER_IP:8081

You’ll see the EaglercraftX title screen — a Minecraft-style menu. Enter any username (no account needed), click Multiplayer, and the local server is already pre-configured in the list. Click it and join.

Find your host IP:

hostname -I | awk '{print $1}'

Want Minecraft 1.12.2 instead?

#

The default setup runs 1.8.8 — stable and well-tested. If you want newer gameplay features (horses, dual-wielding, elytra, shields, observers, and more), there’s an experimental 1.12.2 branch with a simpler single-process architecture.

To try 1.12.2, just change the clone and build commands:

git clone -b v1.12.2 https://github.com/hackboxguy/eaglercraft-docker.git
cd eaglercraft-docker
docker build -t eaglercraft-1.12.2-server:local .
docker compose up -d

Everything else in this guide (dashboard, safety, backups, ports) applies to both versions. The only other difference is the server console command — see the Server console section below.

Browser-based client (no native install)

#

Every player joins directly in Chrome/Firefox using the Eaglercraft web client served by your local Docker stack. This eliminates setup friction for kids and guests — no downloads, no Java, no launcher.

Parent/Admin controls

#

Admin dashboard

#

Open http://YOUR_SERVER_IP:8082 to monitor:

• Player activity
• Session history
• Server performance trends

Server console

#

docker exec -it eaglercraftx-server supervisorctl fg spigot

docker attach eaglercraft-1.12.2-server

Useful commands (both versions):

list
op PlayerName
whitelist add PlayerName
ban PlayerName

Family safety checklist

#

Backups

#

Backup everything:

tar -czf eaglercraft-backup-$(date +%Y%m%d).tar.gz data/

Restore:

tar -xzf eaglercraft-backup-YYYYMMDD.tar.gz

Daily operations

#

Troubleshooting

#

Port/listener check:

ss -tlnp | grep -E '8081|8082'

Service status and logs:

docker exec eaglercraftx-server supervisorctl status
docker compose logs eaglercraft
docker exec eaglercraftx-server tail -f /opt/eaglercraft/logs/spigot.log
docker exec eaglercraftx-server tail -f /opt/eaglercraft/logs/bungee.log

docker compose logs eaglercraft
docker exec eaglercraft-1.12.2-server tail -f /opt/eaglercraft/logs/server.log

Known limitations

#

• Initial build requires internet to download server components
• The build pulls upstream artifacts (server JARs, plugins) at build time — exact binaries may change between builds unless pinned or checksummed
• This setup prioritizes LAN simplicity, not hardened internet hosting

Legal note

#

hackboxguy/eaglercraft-docker

A complete, self-contained Eaglercraft server that runs Minecraft v1.8.8 in web browsers without requiring Minecraft accounts or installations. Perfect for offline family gaming!

Dockerfile

2

0