Guides · hosting · Everyday developer services

Fly.io app and deploy token

Create a Fly.io account with flyctl, launch an app, add a card before the short trial ends, and create a scoped deploy token for CI.

Researched · not yet run liveLast researched 25 October 2026 · Fly.io · provider site

Researched, not yet run live. Built from the provider’s official pages (linked below). A person hasn’t walked this flow end to end yet, so check each step against the source.

Who owns what

A Fly.io user belongs to organizations; apps belong to an organization, which holds the card and billing.

  • Fly.io user personal owned by the person
  • Organization billing · under Fly.io user

Have ready

  • A card to add to the organization. · The trial is only 2 hours of Machine runtime or 7 days; a card is needed to keep using billable resources after that. [3]Needed for: Add a card to the organization

Steps

Steps marked “human step” are ones only you can do: verapli never signs in, submits, pays or accepts terms for you.

  1. Create or sign in to a Fly.io account

    Install flyctl and run fly auth signup (or fly auth login); the person completes sign-up in the browser.

    • Guided by hand
    • Human step: You press submit
  2. Launch the app

    Run fly launch inside the project directory to create and configure the app (it usually deploys too), then fly deploy for later changes.

    • Guided by hand
    • Human step: You press submit
    • After: Create or sign in to a Fly.io account
  3. Add a card to the organization

    Add a payment method before the trial ends so Machines keep running.

    • Guided by hand
    • Human step: You add payment details
    • After: Create or sign in to a Fly.io account
    The provider says
    Trial lasts up to 2 hours of Machine runtime or 7 days, whichever comes first. [3]
  4. Create a deploy token

    Run fly tokens create deploy --name "<name>" --expiry <duration> (or use the app's Tokens page in the dashboard). Set a short expiry; the default is 20 years. verapli stores it as FLY_API_TOKEN.

    • Guided by hand
    • Human step: You press submit
    • After: Launch the app

Terms and gotchas

Plain-English summary, not legal advice. Each card links its source.

Can cost moneyThe rules say

No free tier

New organizations have no free tier; the trial ends after 2 Machine-hours or 7 days, and billable resources then need a card. Billing is pay as you go. [3]

Worth knowingThe rules say

Tokens default to 20 years validity; pass --expiry and prefer app-scoped deploy tokens over org tokens. [2]

What you end up with

Env varSecretFormatWhat it is
FLY_API_TOKENsecretFly.io access token read by flyctl; a deploy token is scoped to one app.

Pricing

  • Free tier: No free tier; trial of up to 2 hours Machine runtime or 7 days.
  • Costs: Pay As You Go, no monthly platform fee; Machines billed per second while running.

Source [3]

For agents

The same entry as JSON: /api/v1/entries/fly-io/app · requirements /api/v1/requirements/fly-io/app · terms /api/v1/terms/fly-io/app.

Remote MCP (read-only, no auth)
claude mcp add --transport http verapli https://verapli.com/mcp

> "What do I need for Fly.io app and deploy token, and how long will it take?"
  → tools/call requirements { "provider_id": "fly-io/app" }

Sources

  1. Launch a new app on Fly.io Install flyctl; fly auth signup or fly auth login; fly launch from the source directory creates, configures and usually deploys; fly deploy. · accessed 25 October 2026 · official
  2. Access tokens Deploy (app-scoped), SSH, machine-exec, org and read-only org tokens; fly tokens create deploy --name --expiry; default validity 20 years; FLY_API_TOKEN env var used by flyctl; dashboard app or org Tokens page; fly tokens revoke. · accessed 25 October 2026 · official
  3. Fly.io pricing No free tier for new orgs; trial up to 2 hours of Machine runtime or 7 days; no card to start the trial, card needed afterwards; Pay As You Go with no monthly platform fee; per-second Machine billing. · accessed 25 October 2026 · official
  4. Stripe Projects provider catalogue Fly.io is listed in the Stripe Projects catalogue as flyio/app (Hosting, Database). · accessed 25 October 2026 · official

Provider rules change. This page is generated from verapli registry version 2026.1025.316; spotted something out of date? Tell us. Fly.io is not affiliated with verapli.