# Palworld Dedicated Server

> Palworld dedicated server with RCON management and automatic backups.

- Category: Home Lab & Self-Hosting
- Difficulty: intermediate
- Components: palworld-server, rcon-cli
- Tags: palworld, gaming, dedicated-server, rcon
- Source: https://docker.recipes/homelab/palworld-server

## Overview

Palworld is a multiplayer survival crafting game that combines creature collection with base building and combat mechanics. Running a dedicated Palworld server allows players to create persistent worlds where friends can join and play together without requiring the host player to be online constantly. The dedicated server provides better performance, 24/7 availability, and the ability to customize server settings for optimal gameplay experiences.

This Docker stack combines the thijsvanloef/palworld-server-docker container with itzg/rcon for remote server administration. The Palworld server handles all game logic, world persistence, and player connections, while RCON provides command-line access for server management tasks like player moderation, world saves, and configuration changes without requiring direct server access. The configuration includes automatic backup functionality to prevent world data loss.

This setup is ideal for gaming communities, friend groups wanting private servers, and content creators who need reliable Palworld hosting. The combination offers both the game server itself and administrative tools necessary for proper server management, making it valuable for anyone serious about hosting multiplayer Palworld sessions with proper oversight and data protection.

## Features

- Supports up to 32 concurrent players with configurable player limits
- RCON integration for remote server administration and command execution
- Automatic hourly world backups with configurable cron scheduling
- Multithreading support for improved server performance under load
- Steam update detection and automatic game updates on container restart
- Configurable server privacy settings including password protection
- Persistent world data storage with proper file permissions handling
- Community server listing opt-out for private gaming sessions

## Use cases

- Private gaming servers for friend groups and gaming communities
- Content creator streaming servers with controlled player access
- Gaming clan dedicated servers with administrative oversight
- Development and testing environments for Palworld mods and configurations
- Educational gaming environments for schools and organizations
- 24/7 community servers with scheduled maintenance and backups
- Regional gaming servers for reduced latency in specific geographic areas

## Prerequisites

- Minimum 8GB RAM and 4GB free disk space for world data and backups
- UDP ports 8211 and 27015 available and forwarded through firewall/router
- TCP port 25575 accessible for RCON administration (internal network recommended)
- Steam account ownership of Palworld for dedicated server access
- Basic understanding of game server administration and player management
- Docker Compose version 1.28+ for profiles support

## docker-compose.yml

```yaml
services:
  palworld:
    image: thijsvanloef/palworld-server-docker:latest
    environment:
      - PUID=1000
      - PGID=1000
      - PORT=8211
      - PLAYERS=32
      - MULTITHREADING=true
      - RCON_ENABLED=true
      - RCON_PORT=25575
      - ADMIN_PASSWORD=${ADMIN_PASSWORD}
      - COMMUNITY=false
      - SERVER_NAME=${SERVER_NAME:-Palworld Server}
      - SERVER_PASSWORD=${SERVER_PASSWORD}
      - UPDATE_ON_BOOT=true
      - BACKUP_ENABLED=true
      - BACKUP_CRON_EXPRESSION=0 * * * *
    volumes:
      - palworld-data:/palworld
    ports:
      - "8211:8211/udp"
      - "27015:27015/udp"
      - "25575:25575"
    networks:
      - palworld-network
    restart: unless-stopped

  rcon:
    image: itzg/rcon:latest
    environment:
      - RCON_HOST=palworld
      - RCON_PORT=25575
      - RCON_PASSWORD=${ADMIN_PASSWORD}
    depends_on:
      - palworld
    networks:
      - palworld-network
    profiles:
      - tools

volumes:
  palworld-data:

networks:
  palworld-network:
    driver: bridge
```

## .env

```bash
# Palworld Server
SERVER_NAME=Palworld Server
SERVER_PASSWORD=secure_password
ADMIN_PASSWORD=admin_rcon_password
```

## Usage notes

- Game server on UDP 8211
- RCON management on port 25575
- Automatic updates on boot
- Hourly backups enabled
- Use 'docker compose --profile tools run rcon' for RCON

## Troubleshooting

- Players cannot connect to server: Verify UDP port 8211 is properly forwarded and firewall allows traffic
- RCON connection refused: Ensure ADMIN_PASSWORD environment variable is set and matches between palworld and rcon services
- Server crashes on startup with memory errors: Increase Docker container memory limits and verify host has sufficient RAM
- World data lost after container restart: Check palworld-data volume mounting and verify PUID/PGID permissions match host filesystem
- Steam update failures during boot: Ensure container has internet access and Steam servers are reachable
- Backup creation fails: Verify palworld-data volume has write permissions and sufficient disk space for backup storage

