Docker Management

┌─────────────┐
│   Created   │ Container exists but not started
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  Installing │ Running installation script
└──────┬──────┘
       │
       ▼
┌─────────────┐
│   Stopped   │ Container exists, server offline
└──────┬──────┘
       │
       ▼
┌─────────────┐
│   Starting  │ Container booting up
└──────┬──────┘
       │
       ▼
┌─────────────┐
│   Running   │ Server online and active
└──────┬──────┘
       │
       ▼
┌─────────────┐
│  Stopping   │ Gracefully shutting down
└──────┬──────┘
       │
       ▼
┌─────────────┐
│   Stopped   │
└─────────────┘

{
  "uuid": "server-uuid",
  "container": {
    "image": "ghcr.io/pterodactyl/yolks:java_17",
    "oom_disabled": true
  },
  "build": {
    "memory_limit": 2048,
    "swap": 0,
    "io_weight": 500,
    "cpu_limit": 200,
    "threads": "0-3",
    "disk_space": 10240,
    "oom_disabled": true
  },
  "allocations": {
    "default": {
      "ip": "0.0.0.0",
      "port": 25565
    },
    "mappings": {
      "25565": 25565,
      "25566": 25566
    }
  }
}

memory_limit: 2048  # MB
swap: 0             # MB (0 = disabled)

cpu_limit: 200   # 200% = 2 cores
threads: "0-3"   # Limit to specific CPU cores

disk_space: 10240  # MB
io_weight: 500     # I/O priority (10-1000)

{
  "scripts": {
    "install": "#!/bin/bash\n...",
    "privileged": true
  },
  "config": {
    "container": "debian:buster-slim",
    "entry": "bash"
  },
  "env": {
    "SERVER_JARFILE": "server.jar",
    "MINECRAFT_VERSION": "1.20.1"
  }
}

# Wings pulls images as needed
# View pulled images
docker images | grep pterodactyl

# Manually pull an image
docker pull ghcr.io/pterodactyl/yolks:java_17

# Remove unused images
docker image prune -a

allocations:
  default:
    ip: 0.0.0.0
    port: 25565
  mappings:
    25565: 25565  # container:host
    25566: 25566

docker run -p 25565:25565 -p 25566:25566 ...

/var/lib/pterodactyl/volumes/
├── 1a2b3c4d-5e6f-7g8h-9i0j-1k2l3m4n5o6p/
│   ├── server.jar
│   ├── world/
│   ├── plugins/
│   └── logs/
└── 2b3c4d5e-6f7g-8h9i-0j1k-2l3m4n5o6p7q/
    └── ...

docker run -v /var/lib/pterodactyl/volumes/{uuid}:/home/container ...

allowed_mounts:
  - /opt/shared-configs

{
  "mounts": [
    {
      "source": "/opt/shared-configs",
      "target": "/mnt/configs",
      "read_only": true
    }
  ]
}

SERVER_MEMORY=2048
SERVER_IP=0.0.0.0
SERVER_PORT=25565
MINECRAFT_VERSION=1.20.1
P_SERVER_UUID=1a2b3c4d-5e6f-7g8h-9i0j-1k2l3m4n5o6p

java -Xms128M -Xmx{{SERVER_MEMORY}}M -jar server.jar

# View container stats
docker stats $(docker ps -q)

# View specific server
docker stats ptdl-1a2b3c4d

# View container logs
docker logs -f ptdl-1a2b3c4d

# View last 100 lines
docker logs --tail 100 ptdl-1a2b3c4d

# Containers run with restricted capabilities
--cap-drop=ALL
--cap-add=NET_BIND_SERVICE

# Read-only root filesystem (optional)
--read-only
--tmpfs /tmp

# Security options
--security-opt=no-new-privileges

# List all Pterodactyl containers
docker ps -a --filter "name=ptdl-"

# List running servers
docker ps --filter "name=ptdl-"

# View container details
docker inspect ptdl-1a2b3c4d

# View resource limits
docker inspect ptdl-1a2b3c4d | grep -A 10 HostConfig

# Access container shell
docker exec -it ptdl-1a2b3c4d /bin/bash

# Run command in container
docker exec ptdl-1a2b3c4d ls -la /home/container

# Check container status
docker ps -a --filter "name=ptdl-{uuid}"

# View container logs
docker logs ptdl-{uuid}

# Check Wings logs
journalctl -u wings -n 100

# Identify resource-heavy containers
docker stats --no-stream | sort -k 3 -h

# Check specific container limits
docker inspect ptdl-{uuid} | grep -A 20 HostConfig

# Check volume permissions
ls -la /var/lib/pterodactyl/volumes/{uuid}/

# Fix permissions (if needed)
chown -R 1000:1000 /var/lib/pterodactyl/volumes/{uuid}/

{
  "build": {
    "oom_disabled": true
  }
}

{
  "build": {
    "threads": "0-3"  // Use cores 0-3
  }
}

{
  "build": {
    "io_weight": 750  // Higher = more I/O priority
  }
}