Can it fix Out of Memory (OOM) issues in Docker?

Yes, it analyzes the disparity between container memory limits and PHP's memory_limit, providing optimized settings for both docker-compose.yml and php.ini.

Does it support PHP-FPM pool tuning?

Absolutely. It includes a sizing formula to calculate the ideal max_children and spare server settings based on your container's available memory.

Can it identify permission issues?

Yes, it scans for UID/GID mismatches and incorrect file ownership within Dockerfiles that lead to runtime 'Permission Denied' errors.

How does this skill help with 502 Bad Gateway errors?

It checks if PHP-FPM is running, validates Nginx configurations, and suggests healthcheck patterns to ensure services are ready before accepting traffic.

Docker PHP Runtime Debugger

Name: Docker PHP Runtime Debugger
Author: dykyi-roman

bydykyi-roman

•

Deployment & DevOps

Diagnoses and fixes PHP-FPM and Nginx container failures including 502 errors, OOM kills, and permission issues.

This skill provides Claude Code with specialized expertise in troubleshooting containerized PHP environments. It systematically analyzes logs and configurations to identify the root causes of common runtime failures such as 502 Bad Gateway errors, OOM (Out of Memory) terminations, PHP-FPM pool exhaustion, and networking misconfigurations. By leveraging predefined detection patterns and grep-based diagnostics, it offers actionable fixes for Docker Compose setups, php.ini tuning, and Dockerfile permissions, significantly reducing the time spent debugging infrastructure-level issues in PHP applications.

Key Features

01Analysis of PHP-FPM pool exhaustion and segmentation faults

02Diagnosis of OOM (Out of Memory) kills with memory limit optimization

03Troubleshooting for connection refused and service dependency issues

04Identification of file ownership and permission errors in Docker layers

0545 GitHub stars

06Automated detection of 502 Bad Gateway and PHP-FPM crashes

Use Cases

01Resolving permission denied errors when moving code to a production Docker image

02Optimizing PHP-FPM configuration for high-traffic Docker environments

03Debugging a containerized PHP app that keeps restarting or timing out

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add dykyi-roman/awesome-claude-code analyze-docker-runtime-errors

For use in Claude.ai and ChatGPT

Download Skill