fly-deployment

Configure Fly.io monorepo deployments with per-app Dockerfiles and single volumes.

1|Updated Dec 30, 2025
One-click install
npx skills add https://github.com/SecurityRonin/ronin-marketplace --skill fly-deployment
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fly-deployment
Source: https://github.com/SecurityRonin/ronin-marketplace/tree/main/plugins/deployment-skills/skills/fly-deployment
Command: npx skills add https://github.com/SecurityRonin/ronin-marketplace --skill fly-deployment

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams deploy applications to Fly.io by addressing the one-volume-per-machine limitation, monorepo deployment patterns, and practical Dockerfile guidance.

Core Features & Use Cases

  • Monorepo deployment guidance: place fly.toml at project root and configure per-app deployments, with examples like apps/api and apps/web.
  • Volume management: design deployments with a single volume and subdirectories to avoid multiple mounts.
  • Dockerfile patterns: guidance for Next.js and Python apps, multi-stage builds, and per-app dockerfile organization.
  • Troubleshooting: actionable steps for common issues including Next.js context errors, Dockerfile path mistakes, and TLS proxy considerations.

Quick Start

Create root fly.toml files for each app and run fly deploy --config fly.api.toml and fly deploy --config fly.web.toml from the project root. Ensure Dockerfiles exist at the specified paths (e.g., apps/api/Dockerfile, apps/web/Dockerfile) and that per-app configs reference the correct dockerfile paths.

Frequently Asked Questions about fly-deployment

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

FAQPage Schema
How do I deploy a monorepo to Fly.io with multiple apps?

To deploy a monorepo to Fly.io, place fly.toml files at the project root for each app and run fly deploy with the --config flag for each specific file, such as fly.api.toml and fly.web.toml, ensuring Dockerfiles exist at the correct per-app paths.

Why does my Next.js Fly.io deployment fail with Dockerfile context errors?

Next.js Fly.io deployment failures often stem from incorrect Dockerfile paths in fly.toml or missing build context. Ensure your per-app configuration references the correct Dockerfile location and that multi-stage builds are properly structured.

How do I work around the Fly.io one-volume-per-machine limitation?

To work around the Fly.io one-volume-per-machine limitation, design your deployment to use a single volume with subdirectories instead of attempting to mount multiple volumes on a single machine.

What do I need before configuring Dockerfile deployments on Fly.io?

Before configuring Dockerfile deployments on Fly.io, you need the Fly CLI installed and Docker running locally. You must also create fly.toml configurations at your project root that reference the correct Dockerfile paths.

What are common Fly.io deployment issues with Docker and TLS proxies?

Common Fly.io deployment issues include Dockerfile path mistakes, Next.js build context errors, and TLS proxy considerations. Troubleshooting involves verifying per-app fly.toml configurations and ensuring Dockerfile paths are accurately specified.

Can I use separate Dockerfiles for Python and Next.js apps in a Fly.io monorepo?

Yes, you can use separate Dockerfiles for Python and Next.js apps in a Fly.io monorepo. Configure per-app fly.toml files at the project root that reference the specific Dockerfile paths for each application, such as apps/api/Dockerfile and apps/web/Dockerfile.