() docs

Getting started

What Konnekt needs, where it runs, and how to point it at your first server.

Requirements

Konnekt is one file, with no runtime to install beside it. Three things on top of that:

  • A server jar

    The Minecraft server you already run. Konnekt manages it, it doesn't fetch one.

  • Java

    Your server needs it to run. Konnekt itself doesn't.

  • Windows or Linux

    64-bit. macOS builds from source today.

Platform support

Platform Build Status
Windows (x86-64) konnekt-windows-amd64.exe ALPHA
Linux (x86-64) konnekt-linux-amd64 SNAPSHOT
Fedora / RHEL (x86-64) .x86_64.rpm SNAPSHOT
macOS Build from source SOURCE
  • Rocky and RHEL 9 are not compatible.
  • Linux needs webkit2gtk4.1 and gtk3 at runtime.
  • macOS has no published build; it builds from source.

Your first server

  1. Add a server

    Point it at the jar and the folder it lives in, then name it and give it RAM.

  2. Install a server

    Forge and NeoForge

    Hand it a Forge or NeoForge installer instead and it runs the install for you, then adds what comes out.

  3. Start it

    The console streams the log live and takes commands inline.

  4. Join it

    The server runs on the machine you are sitting at, so its address is localhost. Put that into Minecraft under Multiplayer, Direct Connection as the Server Address, then Join Server.

Player list and commands need enable-rcon on in server.properties until Konnekt sets it up for you.

Build from source SNAPSHOT

A source build is the newest code, so it is a snapshot: newer than the release, and untested.

Requires Go, Node.js with pnpm, and the Wails CLI. On Linux you also need the webkit2gtk and gtk3 development packages. 

git clone https://github.com/kollektiv-mc/Konnekt
cd Konnekt
pnpm install
wails dev

Run wails doctor first; it reports what your distro is missing. If WebKit detection fails, add the build tag: 

wails build -tags webkit2_41
wails dev -tags webkit2_41

FAQ

Is it free?

Yes. Released under CC0, so there's no copyright to ask permission from. No accounts, no tiers, no subscriptions.

Does it phone home?

No telemetry, analytics or crash reporting. Konnekt reaches the network in three cases: GitHub for update checks, Modrinth for mods, and your own server over RCON.

Which server types work?

Vanilla, Paper/Spigot/Bukkit, and modded Fabric, Forge and NeoForge. The loader is detected automatically. Bedrock isn't supported.

The server stops as soon as I start it

On a first run that is almost always the EULA: Minecraft will not start until you have accepted it, and says so in the log on its way out. Konnekt watches for that line and offers to write eula.txt for you, then starts the server again.

Where does it store my data?

Your server files stay where they are. Konnekt's own state (servers, layouts, presets, scheduled tasks) is JSON in the OS application-data directory.

Is it stable?

It's alpha. The core is functional and in daily use, but expect rough edges. See the roadmap.

Can I run the newest code?

Yes. Snapshots are built from the newest code whenever it changes and published as pre-releases, so you can run features and fixes before they reach a release. They're untested, so Konnekt warns before installing one. Grab the first from the download page; after that a snapshot offers you the next one itself, and a release once one overtakes it. Settings > General has the channel if you want to follow snapshots from a stable build.

Can I manage a server on another machine?

No. Konnekt manages servers on the machine it runs on. Web access is a later roadmap item.

Fair warning

This is a personal side project which was built to run my own Minecraft servers the way I want, rather than to match what a wider community might expect from it. Most of the code comes from Claude, with me reading over its shoulder rather than writing it myself; I'm not a programmer, just someone putting AI tools to use for something I needed. So don't expect a polished, textbook-clean codebase. It works for me, and that's the bar I'm holding it to.

I have no interest in gatekeeping any of this, so take the code and do what you want with it — fork it, extend it, rebuild it, whatever. It's released under CC0, so there's no copyright to ask permission from.