Configuration

Complete reference for all configuration options in KyuubiSoft Panel.

Environment Variables

Required Variables

These must be set for the panel to function:

Variable	Description	Example
JWT_SECRET	Token signing key (min 32 chars)	openssl rand -base64 48
MANAGER_USERNAME	Admin login username	admin
MANAGER_PASSWORD	Admin password (min 12 chars)	SecurePass123!
CORS_ORIGINS	Allowed API origins	http://localhost:18080

Server Configuration

Variable	Default	Description
JAVA_MIN_RAM	3G	Minimum JVM heap size
JAVA_MAX_RAM	4G	Maximum JVM heap size
SERVER_PORT	5520	Game server port (UDP)
SERVER_BIND	0.0.0.0	Network bind address
AUTH_MODE	authenticated	authenticated or offline
TZ	Europe/Berlin	Container timezone

Download Options

Variable	Default	Description
USE_HYTALE_DOWNLOADER	false	Use official Hytale downloader
HYTALE_PATCHLINE	release	release or pre-release
AUTO_UPDATE	false	Auto-update on restart
SERVER_JAR_URL	-	Custom JAR download URL
ASSETS_URL	-	Custom assets download URL

Panel Configuration

Variable	Default	Description
MANAGER_PORT	18080	Web panel port
TRUST_PROXY	false	Enable for reverse proxy
SECURITY_MODE	strict	strict or warn
DEMO_MODE	false	Run with mock data

Resource Limits

Variable	Default	Description
DOCKER_MEMORY_LIMIT	8G	Container memory limit
DOCKER_CPU_LIMIT	4	Container CPU limit

Backup Configuration

Variable	Default	Description
ENABLE_BACKUP	false	Enable built-in backups
BACKUP_FREQUENCY	30	Backup interval (minutes)

Optional Integrations

Variable	Description
MODTALE_API_KEY	Modtale mod store API key
STACKMART_API_KEY	StackMart store API key
CURSEFORGE_API_KEY	CurseForge API key (optional)

WebMap Configuration

Variable	Default	Description
WEBMAP_PORT	18081	Live map HTTP port
WEBMAP_WS_PORT	18082	Live map WebSocket port

Docker Volumes

The stack uses these persistent volumes:

Volume	Path	Purpose
hytale-server	/opt/hytale/server	Server JAR and assets
hytale-data	/opt/hytale/data	Worlds, configs, panel data
hytale-backups	/opt/hytale/backups	Backup storage
hytale-plugins	/opt/hytale/plugins	Server plugins
hytale-mods	/opt/hytale/mods	Server mods
hytale-downloader	/opt/hytale/downloader	Downloader credentials
hytale-auth	/opt/hytale/auth	Server auth data

Server Configuration Files

config.json

Main server configuration at /opt/hytale/data/config.json:

{
  "serverName": "My Hytale Server",
  "motd": "Welcome to the server!",
  "maxPlayers": 20,
  "gamemode": "adventure",
  "difficulty": "normal",
  "pvp": true,
  "whitelist": false
}

panel-config.json

Panel-specific settings at /opt/hytale/data/panel-config.json:

{
  "acceptEarlyPlugins": false,
  "disableSentry": false,
  "allowOp": true,
  "patchline": "release"
}

Update Configuration

Native update system settings in server config.json:

{
  "updateConfig": {
    "enabled": true,
    "checkIntervalSeconds": 3600,
    "notifyPlayersOnAvailable": true,
    "patchline": "release",
    "runBackupBeforeUpdate": true,
    "backupConfigBeforeUpdate": true,
    "autoApplyMode": "DISABLED",
    "autoApplyDelayMinutes": 5
  }
}

Auto-Apply Modes:

• DISABLED - Manual updates only
• WHEN_EMPTY - Update when no players online
• SCHEDULED - Update after delay

Reverse Proxy Setup

For HTTPS access via nginx or traefik:

Nginx Example

server {
    listen 443 ssl;
    server_name panel.yourdomain.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://localhost:18080;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

Set in .env:

TRUST_PROXY=true
CORS_ORIGINS=https://panel.yourdomain.com

Multiple Instances

Run multiple servers on the same host:

# Instance 1
STACK_NAME=hytale-prod HOST_DATA_PATH=/opt/hytale-prod docker-compose up -d

# Instance 2
STACK_NAME=hytale-test HOST_DATA_PATH=/opt/hytale-test docker-compose up -d

Each instance gets its own containers and data directory.