Getting Started

Overview

Get productive with Fly in 5 minutes. Install the app, connect your repos, and ship your first release.

Get Up and Running

  1. Download Fly App at fly.jfrog.ai/home - Install the app and sign up to get started.
  2. Create Your Team - Pick a team name. This becomes your private registry at <your-team>.jfrog.io.
  3. Start Working with Fly - Ask your coding agent: “Start working with Fly”. Fly connects your repos, configures your CI, and gets you ready to ship.
  4. Generate Your First Release - Approve the PR and run your workflows. Every push now creates a release with full traceability.
  5. Deploy and Track Your Runtime - Create an environment, connect it to your K8s namespace, and deploy: “Deploy the login fix to staging”. Track what’s running from your coding agent or Fly Chat.

You’re all set. Manage your releases, deploy to any environment, and track your runtime right from your coding agent with natural language.

Download Fly App

The Fly App is your local bridge to Fly. It connects your coding agent, your package managers, and your registry.

  1. Go to fly.jfrog.ai/home and download the Fly App, or copy the curl command and paste it in your coding agent or terminal:
# macOS
curl -fsSL https://fly.jfrog.ai/download/desktop | bash

# Windows (PowerShell)
irm https://fly.jfrog.ai/download/desktop | iex
  1. Grant the necessary permissions when prompted.

Supported platforms: macOS and Windows.

Once installed, the app detects your package managers (npm, pip, Docker, Helm, Maven, Gradle, Go, NuGet) and connects your coding agent (Cursor, Copilot, Claude Code, OpenCode) to work with Fly.

Create Your Team

Sign up and pick a team name. This becomes your private Fly Registry at <your-team>.jfrog.io, where all your releases, packages, and images live. The first user becomes the team Admin with full permissions.

Tip

This is not a web interface. Access Fly Web at fly.jfrog.ai.

Start Working with Fly

Ask your coding agent:

“Start working with Fly”

That’s it. Review the PR, merge, and you’re done.

What Fly does:

Fly opens a GitHub authorization flow, connects your repositories, scans your workflows, and creates a pull request with the CI configuration. The PR adds two things to your workflows:

OIDC permissions for secure, token-free authentication:

permissions:
  contents: read
  id-token: write

Fly action to configure your package managers on the CI runner:

- uses: jfrog/fly-action@v1              # Setup Fly package managers

For Docker, Fly also sets your image path to point to Fly Registry: <your-fly-subdomain>.jfrog.io/docker/my-app:tag

npm workflow example:

steps:
  - uses: actions/checkout@v4
  - uses: actions/setup-node@v4
    with:
      node-version: '18'
  - uses: jfrog/fly-action@v1              # Setup Fly package managers
  - run: npm install                       # Dependencies from Fly registry
  - run: npm run build
  - run: npm publish                       # Publish to Fly registry

Docker workflow example:

steps:
  - uses: actions/checkout@v4
  - uses: jfrog/fly-action@v1              # Setup Fly package managers
  - run: docker build -t ${{ env.FLY_REGISTRY_SUBDOMAIN }}/docker/my-app:${{ github.sha }} .
    # Base images pulled from Fly registry
  - run: docker push ${{ env.FLY_REGISTRY_SUBDOMAIN }}/docker/my-app:${{ github.sha }}
    # Push to Fly registry

Deploy and Track Your Runtime

Once your releases are flowing, connect your runtime environments to complete the picture.

From your coding agent:

“Create a staging environment”

Fly creates the environment and helps you connect it by generating a token and providing the kubectl command to apply the image pull secret to your K8s namespace. Once connected, every image pull is tracked.

Now you can deploy and track with natural language:

  • “Deploy the login fix to staging”
  • “What’s running in production?”
  • “Is the login fix live in staging?”

What You Get

Your Coding Agent is where you work with Fly. Through Fly MCP, your coding agent can manage releases, configure CI, deploy, and query your runtime, all with natural language.

Fly App is your local bridge. It auto-configures your package managers and coding agent, and keeps your connection to Fly running in the background.

Fly Web is your team’s hub for releases, artifacts, environments, and team management. Access it at fly.jfrog.ai.

Fly Registry is where your packages and images live, at <your-team>.jfrog.io. Every package manager and CI workflow points here.

Next Steps