Help & Diagnostics

First-run checklist and plain-language troubleshooting.

Connection Readiness

Use this before changing settings. It checks the common causes of a blank page or commands that do nothing.

Checking…

First-Run Checklist

  1. The Binhex container is named binhex-minecraftbedrockserver, or the template variable matches its real name.
  2. /var/run/docker.sock is mounted read/write into CraftCommand Center.
  3. /mnt/user/appdata/craftcommand-center/data is mapped to /app/data.
  4. Screen Session is set to auto, Docker User is nobody, and Command Method is attach.
  5. Change the default password and use HTTPS before allowing access outside your trusted home network.
  6. For public reachability, set the external hostname/IP and UDP port from the Admin page.
  7. Map /mnt/user/backups/craftcommand-center to /app/backups for admin server exports.

Account Roles

Viewer

Can view the dashboard, passive server status and health, players, item catalog, achievements, and only their own activity. Cannot send commands.

Operator

Can also use item, XP, kit, teleport, and time controls; refresh players and the console attachment; and run diagnostics.

Admin

Has full access to moderation, configuration, accounts, schedules, backups, and Minecraft lifecycle controls.

Common Problems

Commands return OK, but nothing happens

Run diagnostics, then refresh the Docker/screen attachment. Confirm the live session looks like 140.minecraft and the Docker user is nobody.

The public endpoint shows offline

Confirm the public DNS/IP and UDP port in Admin. The default external mode uses an internet-hosted Bedrock probe. Local mode runs from the Docker host and can fail on routers without NAT loopback even when outside players can connect.

A player is missing from the target list

Use Pull Known Players. If Bedrock does not expose the name in logs or server files, an admin can use Add Player manually.

The Docker page does not show Edit

Create the container from the included deployment template rather than a raw docker run command.

The browser shows old buttons after an update

Hard-refresh the page or clear site cache. Static files use versioned query strings, but some mobile browsers hold older pages longer than expected.

An item icon shows letters instead of Minecraft art

CraftCommand Center loads current Minecraft Wiki inventory sprites and falls back through Invicon, ItemSprite, and BlockSprite names. Check that the phone or browser can reach minecraft.wiki; uncommon technical items may not have a matching wiki image.

Beta Feedback

When reporting a problem, include the CraftCommand Center version, Docker host version, Binhex container name, diagnostics results, browser/device, and the exact button pressed. Do not include passwords or private server addresses.

🐛 Open a GitHub issue