wisdomsky/palsentry repository overview

⁠PalSentry⁠

PalSentry is a modern monitoring and management dashboard for your Palworld⁠ dedicated server.

Monitor players, track activity on a live world map, manage your server, review historical performance metrics, and perform common administrative tasks — all from a single web interface.

⁠Project Page

https://github.com/WisdomSky/PalSentry⁠

⁠Installation

⁠Docker Run

docker run -d -p 3000:3000 -e PALWORLD_REST_URL="http://192.168.1.50:8212" -e PALWORLD_ADMIN_PASSWORD="your Palworld AdminPassword" wisdomsky/palsentry:latest

⁠Docker Compose

services:
  palsentry:
    image: wisdomsky/palsentry:latest
    restart: unless-stopped
    ports:
      - '3000:3000'
    environment:
      PALWORLD_REST_URL: 'http://192.168.1.50:8212'
      PALWORLD_ADMIN_PASSWORD: 'your Palworld AdminPassword'

Once running, PalSentry can now be accessed from the browser:

http://localhost:3000

⁠Features

⁠Live World Map

The live world map displays all of your bases and their locations. It also shows all currently online players and their positions in real time.

⁠Tracking Mode

The map also includes a special Tracking Mode, allowing you to focus on a specific player and automatically follow their movements in real time.

The map keeps the selected player in view even when they travel long distances or teleport to another location.

⁠Wayback Mode

PalSentry records where players are as it runs, so the map can be replayed instead of only showing the present. The Wayback map button on the Players tab opens the last 24 hours with every player PalSentry has seen — including the ones who logged off hours ago.

• Scrub the datetime strip to preview any recorded moment, then click, tap, or use the arrow keys to hold one. The whole range is loaded once, so moving the pointer never issues a request.
• Trails are drawn up to the selected moment and break across outages and region changes, so a line on the map only ever shows movement PalSentry actually observed.
• Players who were not online at the selected moment stay on the map at their last known position, faded and labelled with when they were last seen.
• Current guild bases can be added as context, marked as current rather than historical.
• Cancel Wayback map returns to the live map with live tracking, bases, and pins exactly as they were.

Recording continues while no dashboard is open, at a cadence chosen from the Players tab (5s, 15s, 30s, 1m, or 5m — 60s by default). The cadence is stored in the database, so it survives restarts, and it is independent of PALSENTRY_SAMPLE_INTERVAL_SECONDS. Detail costs storage: the default records about 1,400 positions per player per day, while 5 seconds records about 17,000.

⁠Enhanced Server Tools

PalSentry does more than display server information — it also provides convenient administrative controls directly from the dashboard.

Perform common server operations such as:

• Broadcasting announcements
• Restarting the server
• Shutting down the server
• Kicking players
• Banning and unbanning players

Worldmap overview displays both palpagos islands and world tree maps side by side in the dashboard to keep track of all active players.

⁠Player Management

The dashboard provides a quick overview of currently online players, while the dedicated Players page gives you access to both online and offline player records.

You can view additional information such as when a player was last online and manage players even when they are no longer connected to the server.

You can even permanently ban offline players — no need to wait for them to reconnect before taking action.

⁠Enhanced Server Metrics

PalSentry continuously collects server statistics and stores them for historical analysis.

By default, server metrics are collected every minute and displayed in clean, easy-to-read graphs, allowing you to monitor trends and better understand your server's performance over time.

⁠Environment Variables

Without overrides, the dashboard login is admin / admin, the session secret uses the documented shared default, and destructive actions are enabled. These defaults are convenient on a trusted local network; before exposing PalSentry, add safer overrides under environment.

PALSENTRY_LOGIN_PASSWORD: 'some-cute-username'
PALSENTRY_LOGIN_PASSWORD: 'a-password-stronger-than-love'
PALSENTRY_SESSION_SECRET: 'replace-with-a-random-secret-at-least-32-characters-long'
PALSENTRY_ALLOW_DESTRUCTIVE: 'false'

⁠Persistent Data

PalSentry stores its persistent application data under:

/data

services:
  palsentry:
    image: wisdomsky/palsentry:latest
    restart: unless-stopped
    ports:
      - '3000:3000'
    environment:
      PALWORLD_REST_URL: 'http://192.168.1.50:8212'
      PALWORLD_ADMIN_PASSWORD: 'your Palworld AdminPassword'
    volumes:
      - ./data:/data

This allows historical metrics, player information, and other persistent data to survive container upgrades and recreation.

⁠Security

PalSentry exposes administrative functionality for your Palworld server, so it should be treated as a privileged service.

For production deployments:

• Replace the default admin dashboard password with a strong password.
• Replace the shared default PALSENTRY_SESSION_SECRET with a randomly generated value.
• Set PALSENTRY_ALLOW_DESTRUCTIVE=false unless destructive operations are required.
• Avoid exposing PalSentry directly to the public internet.
• Prefer access through a trusted LAN, VPN, or authenticated reverse proxy.
• Use HTTPS when exposing the dashboard through a reverse proxy.

⁠Updating

⁠Docker Compose

Pull the latest image and recreate the container:

docker compose pull
docker compose up -d

Pull the latest image:

docker pull wisdomsky/palsentry:latest

Then recreate your container using the same /data volume. If you overrode PALSENTRY_SESSION_SECRET, reuse the same value to keep existing sessions valid.