Early development · alpha

A tiny web panel for your Minecraft server on a Raspberry Pi.

Start and stop, follow the console, manage players and settings – from any browser in your home network.

demo.pistonpanel.dev sample data
The PiSton home screen: server online, 6 of 20 players, TPS 19.9, memory 2.6 of 4 GB, CPU 34 %, a player list, recent console output and quick actions.

Try the console

simulated

[18:04:17 INFO] Done (3.214s)! For help, type "help"

[18:12:40 INFO] Steve joined the game

[18:13:02 INFO] <Alex> anyone got spare iron?

> list

There are 6 of a max of 20 players online: Steve, Alex, Mia_Baut, Builder_Max, Creeperfan, Lena_MC

> tps

Target tick rate: 20.0 per second. Average time per tick: 12.4 ms

Try: help · list · tps · say hi

  • 01 / memory < 80 MB target for the panel – the RAM stays with your server
  • 02 / stack Python + Java all it needs – no Node, no build step, no database
  • 03 / network LAN only runs offline at home – no cloud, no account

/ features

Everything a small server needs. Nothing it doesn’t.

Built for one server and a handful of friends – not for hosting companies.

  • Server control

    Start, stop and restart with one click – no SSH session needed.

  • Live console

    Follow the server log in real time, filter it and send commands.

  • Players

    See who is online and manage whitelist, ops and bans.

  • Settings

    Edit server.properties in a clear form – validated, comments kept.

  • Version switching

    Vanilla, Paper or Fabric – with a checksum check and a world backup first.

  • Metrics

    Players, TPS, memory and CPU of your server at a glance.

/ how it works

Your browser talks to PiSton. PiSton talks to your server.

  1. 01

    Browser

    Any phone, tablet or PC in your home network.

  2. 02

    PiSton on your Pi

    A small Python service. Serves the panel and keeps the RCON password to itself.

  3. 03

    Minecraft server

    Your Java server, unchanged. Commands go via RCON, output is read from latest.log.

/ made for a pi

Small enough to share the Pi with your server.

The panel stays out of the way, so the game gets the memory and CPU.

  • Lightweight

    Under 80 MB of RAM is the goal. One dependency besides Python.

  • No build step

    Plain HTML, CSS and JavaScript. Copy the folder, done.

  • Works offline

    Fonts and assets ship with it. No CDN, no tracking, no account.

  • Accessible

    Built towards WCAG 2.2 AA – keyboard, screen readers, clear contrast.

/ open source

Free and open source under AGPL-3.0.

Read the code, follow the progress and report issues on GitHub. PiSton is in early development – the demo runs with sample data.

/ install

Installation guide coming with the first release.