Getting started

Installation guide

Follow these steps to get MinePanel running beside your Minecraft server and open it in your browser.

Download the panel

Get the latest minecraft-server-panel.zip from the homepage. It contains the complete Next.js application, ready to run alongside your Minecraft server.

The zip is built on each landing deploy and includes all panel source files.
You will run npm install once after extracting to fetch dependencies.

Extract into your server directory

Unzip the contents directly into the same folder as your server.jar. Do not create a subfolder — the panel expects to live alongside your Minecraft files.

Your server folder should contain package.json, app/, components/, and server.jar.
Existing worlds, plugins, and configs are left untouched.

Install dependencies

Open a terminal in the server folder and run npm install. This downloads Next.js and the other panel dependencies.

npm install
Node.js 18.17+ is required (LTS recommended).
Takes about a minute on a typical connection.

Set your PIN and start the panel

Set a 6-digit PIN for authentication, then start the development server (or use the provided start script).

npm run pin:123456 # replace 123456 with your PIN
npm run dev # or ./start.sh on Unix systems
The panel listens on http://0.0.0.0:3000 by default.

Open the panel in your browser

Visit the panel in your browser. From the same machine use localhost; from other devices on your LAN use the server’s IP address.

http://localhost:3000
http://192.168.1.42:3000 (example LAN IP)
Enter the PIN you set earlier. All communication stays on your local network.

Additional information

Keeping the panel updated

Run `npm run app:update` inside the panel folder. It downloads the latest panel zip and replaces only the app files while preserving your PIN, .env.local, node_modules, and all Minecraft data (worlds, plugins, server.jar, etc.).

Security & access

The panel uses a simple 6-digit PIN stored in .minepanel/auth.json. It binds to all interfaces (0.0.0.0) so you can access it from other devices on your network. For production use, consider running it behind a reverse proxy with HTTPS.

Troubleshooting

Port 3000 already in use? Set PORT=3001 in .env.local
Permission errors on Linux/macOS? Fix folder ownership
Panel won’t start after update? Delete node_modules and run npm install again
Java not found? The panel itself doesn’t need Java — only your Minecraft server does

Download the panel Back to homepage