carbon-panel

module
v1.0.38 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 20, 2026 License: MIT

README

Carbon Panel

Carbon Panel Logo
The modern Minecraft server management platform with IBM Carbon UI

GitHub • Issues

Why Carbon Panel?

Because managing Minecraft servers should be fast, reliable, and modern:

  • IBM Carbon UI - Sleek enterprise-grade interface styled with Carbon tokens (2x grid, Plex typography, responsive collapsible navigation, high-contrast dark palette).
  • Docker-Powered Isolation - Each Minecraft server runs safely inside its own container. No host dependency collisions or "works on my machine" issues.
  • Multi-Server & Multi-Node Orchestration - Run vanilla, modded, Paper, Fabric, Forge, NeoForge, and custom servers concurrently with distributed node placement.
  • Intelligent Reverse Proxy - Route player traffic dynamically through hostnames with automatic SRV handling on port 25565 without port-forwarding gymnastics.
  • Modpack Studio & Direct CurseForge Integration - Native keyless CurseForge & Modrinth search, version resolution, packwiz support, and direct .mrpack export.
  • Automated Lifecycle - Auto-start, auto-stop, auto-restart on schedule or event triggers.
  • Modern Proto-based API - Built with Protocol Buffers and Connect RPC (proto/carbonpanel/v1) for robust, type-safe API client generation.

What is Carbon Panel?

Carbon Panel is a high-performance, web-based Minecraft server, proxy, and modpack management platform designed with the IBM Carbon Design System. Built for developers, homelab operators, and community hosts who demand clean, dependable server orchestration without bloated interfaces.


Quick Start

Build From Source

Requirements:

  1. Go (v1.24+)
  2. Bun (v1.2+)
# Clone the repository
git clone https://github.com/athNdev/carbon-panel.git
cd carbon-panel

# Generate the RPC/API code using buf in docker (optional if pre-generated)
docker run --rm -v "$(pwd):/workspace" -w /workspace bufbuild/buf:latest generate

# Install dependencies and build the Carbon frontend
cd web/carbon-panel && bun install && bun run build && cd ../..

# Build backend binary
go build -o carbon-panel cmd/carbon-panel/main.go

# Start Carbon Panel
./carbon-panel

# Open your browser:
# http://localhost:8080 (Production) or http://localhost:5174 (Carbon Vite Dev)
Live Development (Hot Reloading)

Start both the Go backend (with Air live reload) and SvelteKit frontend (with Vite HMR) concurrently:

# Using Bun (Recommended):
bun run dev

# Or using Make:
make dev

# Or on Windows (PowerShell):
.\scripts\dev.ps1

# Or on Linux/macOS (Bash):
./scripts/dev.sh
  • Frontend (Vite HMR): http://localhost:5174 (auto-proxies API, RPC, and WebSocket traffic to :8080)
  • Backend API: http://localhost:8080 (automatically rebuilds and restarts on Go source changes)

Docker Deployment

Docker Run
docker run -d \
  --name carbon-panel \
  --restart unless-stopped \
  --network host \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v ./data:/app/data \
  -v ./backups:/app/backups \
  -v ./tmp:/app/tmp \
  -v ./config.yaml:/app/config.yaml:ro \
  -e CARBONPANEL_DATA_DIR=/app/data \
  -e CARBONPANEL_HOST_DATA_PATH="$(pwd)/data" \
  -e TZ=UTC \
  carbon-panel:latest
services:
  carbon-panel:
    image: carbon-panel:latest
    container_name: carbon-panel
    restart: unless-stopped

    # Option 1 (Recommended): Use host network mode
    network_mode: host

    # Option 2: Bridge mode with port mapping
    # ports:
    #   - "8080:8080"         # Carbon Panel Web Interface
    #   - "25565:25565"       # Minecraft Default Proxy Port
    #   - "25565-25665:25565-25665/tcp"

    volumes:
      # Docker socket for orchestrating server containers
      - /var/run/docker.sock:/var/run/docker.sock
      # Data directories on the host
      - ./data:/app/data
      - ./backups:/app/backups
      - ./tmp:/app/tmp
      #- ./config.yaml:/app/config.yaml:ro

    environment:
      - CARBONPANEL_DATA_DIR=/app/data
      - CARBONPANEL_HOST_DATA_PATH=/opt/carbon-panel/data
      - TZ=UTC

    extra_hosts:
      - "host.docker.internal:host-gateway"

Key Capabilities

Server Management
  • Deploy servers in seconds across Vanilla, Paper, Purpur, Spigot, Fabric, Forge, NeoForge, and Quilt.
  • Real-time live console log streaming and interactive RCON shell.
  • Automatic Java runtime selection (Java 8, 11, 17, 21+).
  • Fine-grained CPU and RAM allocation with Aikar's optimized JVM flag presets.
Reverse Proxy System
  • Subdomain-based virtual hosting (survival.yourdomain.com, creative.yourdomain.com).
  • Single-port ingress (25565) multiplexed to dozens of internal containers.
  • Dynamic route registration on container state change.
Modpack Studio
  • Built-in CurseForge and Modrinth search and download engine.
  • Packwiz-compatible exports and live loader version resolution.
  • Server-side dependency resolution and automated file staging.
Security & Access Control
  • Built-in role-based access control (Admin, Editor, Viewer).
  • Emergency recovery key generation for offline admin recovery.
  • JWT session management and OpenID Connect (OIDC) single sign-on integration.

Configuration

Carbon Panel loads configuration from config.yaml or environment variables:

server:
  port: "8080"
  host: "0.0.0.0"

storage:
  data_dir: "./data"
  backup_dir: "./backups"

proxy:
  enabled: true
  base_url: "minecraft.yourdomain.com"
  listen_ports: [25565]

API & Extensibility

Carbon Panel provides a comprehensive Connect-RPC & gRPC API:

# List managed servers
curl http://localhost:8080/carbonpanel.v1.ServerService/ListServers

# Restart a server
curl -X POST http://localhost:8080/carbonpanel.v1.ServerService/RestartServer \
  -H "Content-Type: application/json" \
  -d '{"id": "your-server-id"}'

Acknowledgments & Credits

Carbon Panel (formerly MineServer) is built upon the open-source foundation of the original DiscoPanel project created by nickheyer.


License

This project is licensed under the terms of the MIT License.

Directories

Path Synopsis
cmd
carbon-panel command
geyser command
status command
internal
db
reconciler
Package reconciler contains the event-source foundation for a future self-healing reconciler (MINE-107).
Package reconciler contains the event-source foundation for a future self-healing reconciler (MINE-107).
rpc
s3
ws
pkg
web

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL