fossfrog/spawnpoint

Spawnpoint

https://img.shields.io/docker/v/fossfrog/spawnpoint?label=Docker%20Hub&logo=docker](https://hub.docker.com/r/fossfrog/spawnpoint)

A self-hosted Minecraft server management dashboard. Run and manage multiple Minecraft servers from a single web UI, with real-time console, file management, backups, and player tracking — all containerized with Docker.

Screenshots

!Dashboard

!Console

!File Manager

!Mods

!New Server

Features

• Start, stop, and monitor multiple Minecraft servers
• Real-time console with command input via WebSocket
• File manager with editor, upload, download, and conflict resolution
• World backups with modpack version detection (BCC, CurseForge, Modrinth, MultiMC)
• Player list with online count
• Import servers from Prism Launcher exports
• Supports NeoForge, Fabric, Forge, and vanilla via https://github.com/itzg/docker-minecraft-server

Requirements

• Docker with Compose
• Docker socket access (the dashboard manages containers on your behalf)

Setup

Create a docker-compose.yml:

yaml
services:
  spawnpoint:
    image: fossfrog/spawnpoint:latest
    container_name: spawnpoint
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /your/data/path:/app/data
    environment:
      - DATA_DIR=/app/data
      - PORT=3000
      - DASHBOARD_USER=admin
      - DASHBOARD_PASSWORD=yourpassword
      # Optional — only needed on Docker Desktop (macOS/Windows):
      # - HOST_DATA_DIR=/your/data/path

Replace /your/data/path with an absolute path on your host where server data will be stored.

Start it:

bash
docker compose up -d

Open http://localhost:3000 in your browser.

Building from source

bash
git clone https://github.com/Gren-95/spawnpoint.git
cd spawnpoint
cp .env.example .env  # edit as needed
docker compose up -d --build

Environment Variables

Development

Backend (Bun + Express + TypeScript):

bash
cd backend
bun install
bun run dev

Frontend (Vite + React + TypeScript):

bash
cd frontend
npm install
npm run dev

The frontend dev server proxies API requests to the backend at http://localhost:3001.

Tech stack

Backend

• https://bun.sh — runtime and package manager
• https://expressjs.com — HTTP server
• https://github.com/apocas/dockerode — Docker API client
• https://github.com/websockets/ws — WebSocket server for real-time console
• https://github.com/WiseLibs/better-sqlite3 — embedded database for server configs and backups
• https://github.com/archiverjs/node-archiver — backup zip creation
• https://github.com/thejoshwolfe/yauzl — zip extraction for Prism imports

Frontend

• https://react.dev — UI framework
• https://vitejs.dev — dev server and build tool
• https://tailwindcss.com — styling
• Zustand — client state management
• React Router — client-side routing
• Lucide — icons

Infrastructure

• https://www.docker.com — containerisation
• https://github.com/itzg/docker-minecraft-server — Minecraft server image

How it works

Spawnpoint runs as a Docker container with access to the Docker socket. When you create or start a server, it spins up a separate itzg/minecraft-server container with the appropriate configuration, bind-mounting a subdirectory of HOST_DATA_DIR as the server's data volume.

The dashboard communicates with running servers over RCON (commands) and Docker logs (console output).