flyio-common-errors
Diagnose and fix common Fly.io errors including deployment failures, health check failures, machine issues, and networking problems. check". '
Profile →npx skills add jeremylongshore/claude-code-plugins-plus-skills --skill flyio-common-errors --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Fly.io Common Errors ## Overview Quick reference for the most common Fly.io deployment and runtime errors with solutions. ## Error Reference ### Health Check Failed ``` Error: health checks for machine e784... failed ``` **Causes:** App not listening on correct port, slow startup, missing dependencies. **Fix:** ```bash # Check logs for startup errors fly logs -a my-app # Verify internal_port matches your app grep internal_port fly.toml # SSH in and test manually fly ssh console -C "curl localhost:3000/health" # Increase health check grace period ``` ```toml # fly.toml — give app more time to start [http_service.checks] grace_period = "30s" interval = "15s" timeout = "5s" ``` ### Deployment Failed — Image Build ``` Error: failed to build: exit code 1 ``` **Fix:** ```bash # Test Docker build locally first docker build -t test . docker run -p 3000:3000 test # Check Dockerfile — common issues: # - Missing EXPOSE directive # - Wrong WORKDIR # - npm install before COPY (layer caching) ``` ### Machine Won't Start ``` Error: machine e784... failed to start ``` **Fix:** ```bash # Check machine events fly machine status e784... # Common cause: OOM — increase memory fly scale vm shared-cpu-
- Overview
- Error Reference
- Health Check Failed
- Deployment Failed — Image Build
- Machine Won't Start
- Connection Refused on .internal
- Volume Mount Failures
- Rate Limited by Machines API
- Quick Diagnostic Commands
- Resources
- Next Steps
Check logs for startup errors fly logs -a my-app Verify internal_port matches your app grep internal_port fly.toml SSH in and test manually fly ssh console -C "curl localhost:3000/health" Increase health check grace period Test Docker build locally first docker build -t test . docker run -p 3000:3000 test
What does the flyio-common-errors skill do?
Diagnose and fix common Fly.io errors including deployment failures, health check failures, machine issues, and networking problems. check". '
How do I install it?
Run `npx skills add jeremylongshore/claude-code-plugins-plus-skills --skill flyio-common-errors --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From jeremylongshore/claude-code-plugins-plus-skills, a repository with 2,630 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.