indiekku

Lightweight game server orchestration

Documentation
v0.5.0

What is indiekku?

indiekku is a lightweight game server orchestration tool. It manages Docker containers for dedicated game servers (Unity, Godot, custom binaries), providing a simple CLI, REST API, and web UI for lifecycle management.

Quick Start

# Install indiekku
curl -fsSL https://indiekku.mironsulicz.dev/install.sh | bash

# Start the API server
indiekku serve

Navigate to http://localhost:3000 to access the web UI

Features

Simple CLI

Start, stop, and list game servers with intuitive commands

Web UI

Modern web interface for uploading and managing server builds

History Tracking

SQLite-powered persistent history of server events and uploads

API Key Authentication

Secure API access with automatically generated keys

Rolling Deployment Support

Upload new builds without affecting running servers

Docker-based

Isolated server instances with automatic port management

REST API

Programmatic server control via HTTP endpoints

Dockerfile Presets

Built-in presets for Unity servers and generic binaries

Background Daemon

API server runs in the background for persistent management

Port Allocation

Automatic port assignment starting from 7777

Usage

CLI Commands

# Start a game server (auto-assigns port 7777, 7778, etc.)
indiekku start

# Start on a specific port
indiekku start --port 7779

# List running servers
indiekku ps

# Stop a server (use server name from 'ps' output)
indiekku stop legendary-sword

# View logs
indiekku logs

# Shutdown the API server
indiekku shutdown

Web Interface

  1. Navigate to http://localhost:3000 and login with your API key
  2. Drag and drop a ZIP file containing your server build
  3. Select a Dockerfile preset (Unity, Binary) or upload a custom Dockerfile
  4. Set the internal port your server listens on
  5. Click "Start Server" to launch new game server instances
  6. View all running servers with names, ports, player counts, and uptime
  7. Navigate to the History page to view server events and upload history