A lightweight open source web-based server panel for hosting game and application servers on Windows.
A lot of game servers and small applications run on spare hardware like old optiplex, or thinkpad laptops and desktops. Setting up Pterodactyl or a similar panel on that kind of hardware means installing Docker, configuring MySQL, overall just quite a lot of un-needed work. stackpatch is built for that gap. It runs directly on Windows without containers or external databases, uses a single SQLite file for persistence, and aims to stay small enough, to not burn any 3rd gen intel core i3 you plan to run it on.
- Start, stop, restart, and terminate server instances
- Live console output with real-time log streaming
- Send commands directly to running processes
- Multiple instances running in parallel
- User management and instance access control
- Scheduled actions per instance
- Memory and CPU limiting per instance
- Works with Minecraft (Paper and others), Python apps, Java applications, and most processes that run from a command line
Install these before running stackpatch:
Windows 10 or later.
Node.js 22.5 or later (https://nodejs.org/) - required by start.bat and nev scripts.
Optional
- pnpm 9 — not required upfront;
start.batandpnpm run start:prodfetchpnpm@9.15.9automatically on first run. Install manually if you prefer:npm install -g pnpm@9 - Runtimes for your instances — e.g. Java 25 for Minecraft (Temurin), Python, Node.js, depending on what you host. The panel does not install these for you.
Before first start
- Ensure ports 23333 (panel) and 24444 (daemon IPC) are free, or change them later in system settings.
- On Windows, use
start.batto launch the panel, which will build the panel UI, and installing any missing pre-requisites
Clone the repo:
git clone https://github.com/saltgranule/stackpatch
cd stackpatchRecommended: run start.bat on Windows. It builds the panel UI, installs any missing pre-requisites, and starts the panel (same as pnpm run start:prod).
Open http://localhost:23333 in your browser.
Default login: admin / changeme (change after first sign-in).
Development (UI hot reload, Vite middleware):
git clone https://github.com/saltgranule/stackpatch
cd stackpatch
pnpm install
pnpm run devpackages/
ui/ React + Vite frontend api/ Fastify backend, REST and WebSocket daemon/ Node.js process manager, communicates via TCP IPC shared/ Types and protocol definitions shared across packages
area's of this panel's original design were heavily influenced by the TVA or Time Variance Authority entity from the Loki show on Disney plus. components are often solid, borderless, with a retro, warm, pastel feel. Mobile support is around 80% done, though it is still very much in progress. full light/darkmode themeing.
aspects of claude were utilisied in late-stage development of this project, ensuring that the correct, and safest versions of dependencies were used. This is clarified here, and in the contributors insight tab.
nothing to see here yet...
Panel port 23333 Open at http://localhost:23333, configurable via system_settings
Daemon IPC port 24444 Configurable via system_settings or env
Data directory .data/ SQLite database and daemon heartbeat file + instances
MIT License