fly-ssh

Run direct commands on Fly.io machines via the Fly SSH console.

36|6|Updated Apr 6, 2022
One-click install
npx skills add https://github.com/rubys/showcase --skill fly-ssh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fly-ssh
Source: https://github.com/rubys/showcase/tree/main/.claude/skills/fly-ssh
Command: npx skills add https://github.com/rubys/showcase --skill fly-ssh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the frustration of debugging Fly.io deployments by providing clear, actionable guidance on using fly ssh console. It addresses common pitfalls like the lack of a shell, differences between Debian Linux and macOS commands, and ensuring machines are running, allowing you to quickly inspect and troubleshoot production issues.

Core Features & Use Cases

  • Direct Command Execution Guidance: Learn how to run commands effectively without a shell, avoiding common errors with pipes, redirection, and shell operators.
  • Debian Linux Command Reference: Get the correct syntax for essential Linux commands (ps, df, cat, netstat) tailored for Fly.io's Debian environment.
  • Troubleshooting & Debugging: Provides solutions for "no machines available" or "connection refused" errors, and tips for checking process status, memory usage, and environment variables.
  • Use Case: When a production application on Fly.io is experiencing high memory usage, use this skill to quickly SSH into the machine, identify the top memory-consuming processes, and inspect relevant log files without needing to understand the nuances of Fly.io's SSH environment.

Quick Start

Use the fly-ssh skill to check the memory usage of the 'smooth-nav' application on Fly.io and list the top 20 processes by memory consumption.

Frequently Asked Questions about fly-ssh

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug high memory usage on my Fly.io production application?

Use fly ssh console to run direct commands on your Fly.io machine and inspect memory consumption. Execute `ps aux` to list processes with memory stats, or use `free -h` to check overall memory usage, then identify and troubleshoot the top memory-consuming processes without needing shell operators.

Can I run commands directly on a Fly.io machine without a shell?

Yes, fly ssh console executes direct commands without a shell environment. Use the -C option to invoke single commands like `ps`, `df`, or `cat` directly; avoid pipes and redirection since shell operators aren't available in this execution mode.

How do I check if my Fly.io machine is running before SSH debugging?

Before using fly ssh console, verify your machine is running by checking its status in the Fly.io dashboard or via the fly CLI. If no machines are available, start the machine first; connection refused errors often stem from stopped instances rather than SSH configuration issues.

What Linux commands work with Fly.io SSH on Debian-based hosts?

Fly.io machines run Debian Linux, so standard Linux commands like `ps`, `df`, `cat`, `netstat`, and `ls` work directly. However, macOS and Debian command syntax differ—use Debian equivalents, and avoid shell pipes or redirects since direct-command execution doesn't support them.

How do I inspect logs and network ports on a Fly.io machine via SSH?

Use fly ssh console with direct commands to examine logs via `cat /path/to/logfile` and check active ports with `netstat -tuln` or `ss -tuln`. Run region-specific or multi-application workflows by targeting the correct machine and application before executing inspection commands.

What errors should I expect when using Fly.io SSH, and how do I fix them?

Common errors include "no machines available" (start the machine first) and "connection refused" (verify machine is running and in the correct region). Understanding Fly.io's no-shell execution model and using explicit machine-start checks before SSH reduces troubleshooting friction significantly.