{"id":34254901,"url":"https://github.com/supersunho/docker-palworld-server","last_synced_at":"2026-03-13T15:37:59.756Z","repository":{"id":301517173,"uuid":"1009447976","full_name":"supersunho/docker-palworld-server","owner":"supersunho","description":"🎮 Production-ready Palworld dedicated server with ARM64 optimization, FEX emulation, auto-management, Discord notifications, and enterprise backup system.","archived":false,"fork":false,"pushed_at":"2025-12-31T11:09:13.000Z","size":307,"stargazers_count":5,"open_issues_count":2,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-04T10:25:43.263Z","etag":null,"topics":["arm64","dedicated","dedicated-server","docker","fex","palworld","server"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/supersunho/palworld-server","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/supersunho.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-27T06:36:09.000Z","updated_at":"2025-12-31T11:09:16.000Z","dependencies_parsed_at":"2025-12-12T14:08:16.592Z","dependency_job_id":null,"html_url":"https://github.com/supersunho/docker-palworld-server","commit_stats":null,"previous_names":["supersunho/docker-palworld-server"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/supersunho/docker-palworld-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supersunho%2Fdocker-palworld-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supersunho%2Fdocker-palworld-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supersunho%2Fdocker-palworld-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supersunho%2Fdocker-palworld-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/supersunho","download_url":"https://codeload.github.com/supersunho/docker-palworld-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/supersunho%2Fdocker-palworld-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30469321,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-13T11:00:43.441Z","status":"ssl_error","status_checked_at":"2026-03-13T11:00:23.173Z","response_time":60,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arm64","dedicated","dedicated-server","docker","fex","palworld","server"],"created_at":"2025-12-16T12:24:06.572Z","updated_at":"2026-03-13T15:37:59.748Z","avatar_url":"https://github.com/supersunho.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎮 Palworld Dedicated Server For ARM64\n\n**🚀 Production-ready ARM64 optimized Palworld server with FEX + SteamCMD integration**\n\n## 🌟 What Makes This Special?\n\n### 🔧 **ARM64-Optimized Palworld Server**\n\n-   **Revolutionary FEX Integration**: 3-5x faster than QEMU on ARM64\n-   **Apple Silicon Ready**: M1/M2/M3 Macs with native performance\n-   **Raspberry Pi Support**: Perfect for home servers and edge computing\n-   **AWS Graviton Optimized**: Cloud-native ARM64 deployment\n\n### 🤖 **Intelligent Auto-Management**\n\n-   **🔄 Smart Idle Restart**: Automatically restart when no players for configurable time\n-   **📊 Advanced Health Monitoring**: CPU, memory, disk, and API health checks with auto-recovery\n-   **💾 Enterprise Backup System**: Daily/weekly/monthly rotation with intelligent cleanup\n-   **🎯 Zero-Downtime Updates**: SteamCMD integration with graceful server management\n\n### 🌍 **Multi-Language Discord Integration**\n\n-   **Real-time Notifications**: Player join/leave, server events, backup completion\n-   **4 Languages Supported**: Korean, English, Japanese, Chinese\n-   **Smart Event Filtering**: Configurable notification preferences\n-   **Rich Embeds**: Beautiful Discord messages with server status\n\n## 🚀 Quick Start\n\n### **🐳 One-Command Deploy**\n\n```bash\ndocker run -d \\\n  --name palworld-server \\\n  -p 8211:8211/udp \\\n  -p 8212:8212/tcp \\\n  -p 25575:25575/tcp \\\n  -v palworld-data:/home/steam/palworld_server \\\n  -v palworld-backups:/home/steam/backups \\\n  supersunho/palworld-server:latest\n```\n\n### **📋 Docker Compose (Recommended)**\n\n```yaml\nversion: \"3.8\"\nservices:\n    palworld-server:\n        image: supersunho/palworld-server:latest\n        container_name: palworld-server\n        restart: unless-stopped\n        ports:\n            - \"8211:8211/udp\" # Game Server\n            - \"8212:8212/tcp\" # REST API\n            - \"25575:25575/tcp\" # RCON\n        environment:\n            - SERVER_NAME=🎮 My Palworld Server\n            - MAX_PLAYERS=32\n            - ADMIN_PASSWORD=your-secure-password\n        volumes:\n            - palworld-data:/home/steam/palworld_server\n            - palworld-backups:/home/steam/backups\n            - palworld-logs:/home/steam/logs\n\nvolumes:\n    palworld-data:\n    palworld-backups:\n    palworld-logs:\n```\n\n## ⚙️ Configuration\n\n### **🔧 Essential Environment Variables**\n\n| Variable              | Default             | Description                          |\n| :-------------------- | :------------------ | :----------------------------------- |\n| `SERVER_NAME`         | `\"Palworld Server\"` | 🏷️ Server display name               |\n| `SERVER_PASSWORD`     | `\"\"`                | 🔒 Server join password              |\n| `ADMIN_PASSWORD`      | `\"admin123\"`        | 👑 Admin/RCON password               |\n| `MAX_PLAYERS`         | `32`                | 👥 Maximum player count (1-32)       |\n| `BACKUP_ENABLED`      | `true`              | 💾 Enable automatic backups          |\n| `DISCORD_WEBHOOK_URL` | `\"\"`                | 💬 Discord webhook for notifications |\n| `LANGUAGE`            | `ko`                | 🌍 Language (`ko`/`en`/`ja`)         |\n\n### **⏰ NEW: Idle Restart Feature**\n\n| Variable                     | Default | Description                               |\n| :--------------------------- | :------ | :---------------------------------------- |\n| `IDLE_RESTART_ENABLED`       | `true`  | 🔄 Enable auto-restart when no players    |\n| `IDLE_RESTART_MINUTES`       | `30`    | ⏱️ Minutes to wait before restart         |\n| `DISCORD_EVENT_IDLE_RESTART` | `true`  | 📣 Discord notification for idle restarts |\n\n### **🎮 Game Settings (150+ configurable options)**\n\n| Variable              | Default | Description                  |\n| :-------------------- | :------ | :--------------------------- |\n| `DIFFICULTY`          | `None`  | 🎯 Game difficulty           |\n| `IS_PVP`              | `false` | ⚔️ Enable PvP mode           |\n| `DAY_TIME_SPEED_RATE` | `1.0`   | ☀️ Day time speed multiplier |\n| `EXP_RATE`            | `1.0`   | 📈 Experience gain rate      |\n| `PAL_CAPTURE_RATE`    | `1.0`   | 🎯 Pal capture difficulty    |\n\n[📄 **Complete Environment Variables List**](https://github.com/supersunho/docker-palworld-server/blob/main/.env.sample)\n\n## 🎯 ARM64 Performance Revolution\n\n### **Why FEX Matters**\n\nTraditional ARM64 emulation (QEMU) is slow and resource-heavy. Our FEX integration changes everything:\n\n| Platform      | Boot Time  | Memory Usage | CPU Usage |\n| :------------ | :--------- | :----------- | :-------- |\n| ARM64 + FEX   | ~2 minutes | ~1.2GB       | ~15%      |\n| x86_64 Native | ~2 minutes | ~1.0GB       | ~12%      |\n| ARM64 + QEMU  | ~8 minutes | ~2.1GB       | ~45%      |\n\n### **Optimized FEX Configuration**\n\n```bash\n# Automatically applied in our container\nFEX_ENABLE_JIT_CACHE=1\nFEX_JIT_CACHE_SIZE=1024\nFEX_ENABLE_LAZY_MEMORY_DELETION=1\nFEX_ENABLE_STATIC_REGISTER_ALLOCATION=1\n```\n\n## 📊 Advanced Features\n\n### **🔄 Smart Idle Management**\n\n```bash\n# Automatically restart server when empty\nIDLE_RESTART_ENABLED=true\nIDLE_RESTART_MINUTES=30\n\n# Discord notification in your language\n🇺🇸 \"⏰ No players for 30 minutes. Restarting server (My Server).\"\n🇰🇷 \"⏰ 30분 동안 접속자가 없어 서버(My Server)를 재시작합니다.\"\n🇯🇵 \"⏰ 30分間プレイヤーがいなかったため、サーバー(My Server)を再起動します。\"\n```\n\n### **💾 Enterprise Backup System**\n\n```yaml\nbackup:\n    enabled: true\n    interval_seconds: 3600 # Hourly backups\n    retention_days: 7 # Keep daily for 7 days\n    retention_weeks: 4 # Keep weekly for 4 weeks\n    retention_months: 6 # Keep monthly for 6 months\n    compress: true # Gzip compression\n    max_backups: 100 # Total backup limit\n```\n\n### **📡 REST API \\\u0026 RCON**\n\n```bash\n# REST API endpoints\ncurl http://localhost:8212/v1/api/info\ncurl http://localhost:8212/v1/api/players\ncurl http://localhost:8212/v1/api/settings\n\n# RCON commands\nrcon-cli --host localhost --port 25575 --password admin123 ShowPlayers\nrcon-cli --host localhost --port 25575 --password admin123 \"Broadcast Hello!\"\n```\n\n### **🩺 Health Monitoring**\n\n```bash\n# Built-in health check\ndocker exec palworld-server python /app/scripts/healthcheck.py\n\n# Automatic recovery on failures\n# CPU \u003e 90%, Memory \u003e 95%, API timeouts = auto-restart\n```\n\n## 🛠️ Advanced Usage\n\n### **Multi-Arch Build Commands**\n\n```bash\n# Clone repository\ngit clone https://github.com/supersunho/docker-palworld-server.git\ncd docker-palworld-server\n\n# Build for your platform\ndocker build -t palworld-server .\n\n# Build\ndocker buildx build --platform linux/arm64 -t palworld-server .\n```\n\n### **Custom Configuration File**\n\n```bash\n# Mount your own configuration\ndocker run -d \\\n  -v ./my-config.yaml:/app/config/default.yaml \\\n  -v palworld-data:/home/steam/palworld_server \\\n  supersunho/docker-palworld-server:latest\n```\n\n### **Development Mode**\n\n```bash\n# Run with development tools\ndocker run -it --rm \\\n  -v $(pwd):/app \\\n  -p 8211:8211/udp \\\n  supersunho/palworld-server:latest bash\n```\n\n## 🌍 Multi-Language Discord Notifications\n\n### **Supported Languages**\n\n-   🇰🇷 **Korean** (`ko`) - 한국어 알림\n-   🇺🇸 **English** (`en`) - English notifications\n-   🇯🇵 **Japanese** (`ja`) - 日本語通知\n\n### **Example Notifications**\n\n```yaml\nPlayer Join:\n🇺🇸 \"🎮 Player joined: Steve (5 players online)\"\n🇰🇷 \"🎮 플레이어 참가: Steve (현재 5명)\"\n🇯🇵 \"🎮 プレイヤー参加: Steve (現在5人)\"\n\nServer Restart:\n🇺🇸 \"🔄 Server restarted due to idle timeout\"\n🇰🇷 \"🔄 무접속으로 인한 서버 재시작\"\n🇯🇵 \"🔄 アイドルタイムアウトによるサーバー再起動\"\n```\n\n## 📈 Resource Requirements \\\u0026 Scaling\n\n### **Recommended Specifications**\n\n| Players | CPU Cores | RAM | Storage | Bandwidth |\n| :------ | :-------- | :-- | :------ | :-------- |\n| 1-8     | 2 cores   | 2GB | 10GB    | 5 Mbps    |\n| 9-16    | 4 cores   | 4GB | 15GB    | 10 Mbps   |\n| 17-24   | 6 cores   | 6GB | 20GB    | 15 Mbps   |\n| 25-32   | 8 cores   | 8GB | 25GB    | 20 Mbps   |\n\n### **Cloud Provider Recommendations**\n\n#### **ARM64 Cloud Options** 💚\n\n-   **AWS**: Graviton3/4 instances (c7g, m7g series)\n-   **Oracle Cloud**: Ampere A1 (4 cores, 24GB RAM - Always Free!)\n-   **Hetzner**: CAX series ARM64 VPS\n-   **Scaleway**: ARM64 instances\n\n## 🤝 Community \\\u0026 Support\n\n### **🔗 Links**\n\n-   📦 **Docker Hub**: [supersunho/palworld-server](https://hub.docker.com/r/supersunho/palworld-server)\n-   📂 **GitHub**: [supersunho/docker-palworld-server](https://github.com/supersunho/docker-palworld-server)\n-   🐛 **Issues**: [Report Issues](https://github.com/supersunho/docker-palworld-server/issues)\n-   💬 **Discussions**: [Community Discussions](https://github.com/supersunho/docker-palworld-server/discussions)\n\n## 📜 License \\\u0026 Acknowledgments\n\n**MIT License** - Free for personal and commercial use.\n\n\u003cdiv align=\"center\"\u003e\n\n### **⭐ Love this project? Give it a star! ⭐**\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupersunho%2Fdocker-palworld-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsupersunho%2Fdocker-palworld-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsupersunho%2Fdocker-palworld-server/lists"}