supersunho/palworld-server repository overview

docker run -d \
  --name palworld-server \
  -p 8211:8211/udp \
  -p 8212:8212/tcp \
  -p 25575:25575/tcp \
  -v palworld-data:/home/steam/palworld_server \
  -v palworld-backups:/home/steam/backups \
  supersunho/palworld-server:latest

version: '3.8'
services:
  palworld-server:
    image: supersunho/palworld-server:latest
    container_name: palworld-server
    restart: unless-stopped
    ports:
      - "8211:8211/udp"  # Game Server
      - "8212:8212/tcp"  # REST API
      - "25575:25575/tcp" # RCON
    environment:
      - SERVER_NAME=🎮 My Palworld Server
      - MAX_PLAYERS=32
      - ADMIN_PASSWORD=your-secure-password 
    volumes:
      - palworld-data:/home/steam/palworld_server
      - palworld-backups:/home/steam/backups
      - palworld-logs:/home/steam/logs

volumes:
  palworld-data:
  palworld-backups:
  palworld-logs:

# Automatically applied in our container
FEX_ENABLE_JIT_CACHE=1
FEX_JIT_CACHE_SIZE=1024
FEX_ENABLE_LAZY_MEMORY_DELETION=1
FEX_ENABLE_STATIC_REGISTER_ALLOCATION=1

# Automatically restart server when empty
IDLE_RESTART_ENABLED=true
IDLE_RESTART_MINUTES=30

# Discord notification in your language
🇺🇸 "⏰ No players for 30 minutes. Restarting server (My Server)."
🇰🇷 "⏰ 30분 동안 접속자가 없어 서버(My Server)를 재시작합니다."
🇯🇵 "⏰ 30分間プレイヤーがいなかったため、サーバー(My Server)を再起動します。"

backup:
  enabled: true
  interval_seconds: 3600    # Hourly backups
  retention_days: 7         # Keep daily for 7 days
  retention_weeks: 4        # Keep weekly for 4 weeks
  retention_months: 6       # Keep monthly for 6 months
  compress: true            # Gzip compression
  max_backups: 100          # Total backup limit

# REST API endpoints
curl http://localhost:8212/v1/api/info
curl http://localhost:8212/v1/api/players
curl http://localhost:8212/v1/api/settings

# RCON commands
rcon-cli --host localhost --port 25575 --password admin123 ShowPlayers
rcon-cli --host localhost --port 25575 --password admin123 "Broadcast Hello!"

# Built-in health check
docker exec palworld-server python /app/scripts/healthcheck.py

# Automatic recovery on failures
# CPU > 90%, Memory > 95%, API timeouts = auto-restart

# Clone repository
git clone https://github.com/supersunho/docker-palworld-server.git
cd docker-palworld-server

# Build for your platform
docker build -t palworld-server .

# Build
docker buildx build --platform linux/arm64 -t palworld-server .

# Mount your own configuration
docker run -d \
  -v ./my-config.yaml:/app/config/default.yaml \
  -v palworld-data:/home/steam/palworld_server \
  supersunho/docker-palworld-server:latest

# Run with development tools
docker run -it --rm \
  -v $(pwd):/app \
  -p 8211:8211/udp \
  supersunho/palworld-server:latest bash

Player Join:
🇺🇸 "🎮 Player joined: Steve (5 players online)"
🇰🇷 "🎮 플레이어 참가: Steve (현재 5명)"
🇯🇵 "🎮 プレイヤー参加: Steve (現在5人)"

Server Restart:
🇺🇸 "🔄 Server restarted due to idle timeout"
🇰🇷 "🔄 무접속으로 인한 서버 재시작"
🇯🇵 "🔄 アイドルタイムアウトによるサーバー再起動"