Claude-skill-registry fly

Deploy and manage the photography portfolio backend on fly.io. Use when deploying the app, checking logs, checking status, scaling machines, or managing the fly.io deployment.

install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/fly" ~/.claude/skills/majiayu000-claude-skill-registry-fly && rm -rf "$T"
manifest: skills/data/fly/SKILL.md
source content

Fly.io Management

This skill helps manage the photography portfolio backend deployment on fly.io.

App Information

  • App name:
    photography-portfolio-solitary-fire-836
  • Region: sjc (San Jose, California)
  • Backend directory:
    backend/

Common Commands

Deploy

Deploy the backend to fly.io:

cd backend && fly deploy

For a faster deployment without building (if image is already pushed):

cd backend && fly deploy --no-cache

View Logs

Get real-time logs from the deployed app:

fly logs -a photography-portfolio-solitary-fire-836

Tail logs continuously:

fly logs -a photography-portfolio-solitary-fire-836 -f

Check Status

Check app status and running machines:

fly status -a photography-portfolio-solitary-fire-836

List all machines:

fly machines list -a photography-portfolio-solitary-fire-836

SSH into Machine

Open SSH session to the running machine:

fly ssh console -a photography-portfolio-solitary-fire-836

Execute a single command:

fly ssh console -a photography-portfolio-solitary-fire-836 -C "command here"

Scaling

Scale memory:

fly scale memory 512 -a photography-portfolio-solitary-fire-836

Scale VM count:

fly scale count 1 -a photography-portfolio-solitary-fire-836

Secrets Management

List secrets:

fly secrets list -a photography-portfolio-solitary-fire-836

Set a secret:

fly secrets set SECRET_NAME=value -a photography-portfolio-solitary-fire-836

Troubleshooting

Check recent events:

fly logs -a photography-portfolio-solitary-fire-836 --tail 100

Restart the app:

fly apps restart photography-portfolio-solitary-fire-836

Get machine details:

fly machine status <machine-id> -a photography-portfolio-solitary-fire-836

Deployment Checklist

When deploying:

  1. Ensure you're in the
    backend/
    directory
  2. Check that all secrets are set (if needed)
  3. Run
    fly deploy
  4. Monitor logs with
    fly logs -f
    to verify successful startup
  5. Check status with
    fly status
    to confirm machines are running

Notes

  • The app uses auto-stop/auto-start machines (min_machines_running = 0)
  • Backend runs on port 5001
  • Uses CDN mode (USE_CDN = 'true')
  • Photos directory is
    /app/photos