FAQ
Short answers to the questions asked most about flypod — what it is, whether it needs an account, what it costs, how long deploys last, what it can host, and how versioning works.
flypod turns a folder of static files into a live URL with one command,
npx flypod ./dist, with no account and no configuration. Each answer below is
one or two sentences, followed by a link to the page that goes deeper.
What is flypod?
flypod is a zero-auth deploy primitive: you point it at a folder of static files and get a live URL back in seconds. No account, no config file, no build pipeline. See What is flypod.
Do I need an account to deploy with flypod?
No. Run npx flypod ./dist, or drop a folder at flypod.dev,
and you get a live URL immediately. An account is only needed to make a site
permanent.
How much does flypod cost?
flypod is free. Anonymous deploys cost nothing — no account, no card.
How long do flypod deploys last?
Anonymous deploys expire after 14 days; a visit after that returns 410 Gone, and within minutes the site is deleted and its address returns 404.
Deploys made while logged in are owned and never expire. See
Ephemerality.
Can I use flypod with my AI coding agent?
Yes. Run npx flypod install skill and flypod writes an Agent Skill into
.claude/skills/flypod/ (Claude Code) and .agents/skills/flypod/ (Codex,
Cursor, Gemini CLI, Copilot) — so "deploy this" is enough. See
How to deploy a static site from an AI agent.
What kind of sites can flypod deploy?
Static sites: HTML, CSS, browser JavaScript, images, fonts, and Markdown. flypod runs no server-side code — no functions, no databases, no backend.
How do I publish a new version or roll back?
flypod update ships a change to the same site as a new version, and so
does plain flypod run again in the same folder: only a folder's first deploy
creates a site. flypod --new makes a separate one on purpose. flypod versions lists the history and
flypod rollback makes the previous version live again. Versions that are not
live are kept for 7 days. See
Update & rollback.
How do I capture the deploy URL in a script?
The URL is the only thing on stdout, so URL=$(npx flypod ./dist --quiet)
captures it. For structured output use npx flypod ./dist --json and read the
url field. See Use with agents & CI.
How do I deploy from CI without an interactive login?
Set FLYPOD_TOKEN to an account session token from your secret store, then run
npx flypod ./dist --quiet. Nothing is written to the repo, and the deploy is
owned and permanent.
How big can a flypod deploy be?
Up to 200 files and 10 MB per deploy on flypod.dev (the upload itself may
be at most 12 MB). The CLI checks this before uploading and fails with
too_large, naming the largest files; trim source maps and unused media, or
list them in a .flypodignore. A self-hosted server sets its own limits.
Can I deploy a folder of Markdown?
Yes. If the deployed folder has no root index.html, flypod renders the .md
files into a styled docs site with a sidebar. See
Render Markdown.
What happens to the sites I deployed anonymously when I log in?
flypod login auto-claims every anonymous site that CLI remembers, so they stop
expiring. They keep their URLs. See Accounts & claiming.
Does flypod support a custom domain?
No. Every site is served on a generated <site-id>.flypod.page subdomain. The
site id is 16 hex characters and flypod picks it — you cannot choose the name.
Why are sites on flypod.page and not flypod.dev?
Because a deploy needs no account. Everything anyone uploads is served on
flypod.page, so reputation damage from a bad upload is confined to a domain
flypod does not otherwise depend on; flypod.dev keeps the API, the docs, the
marketing site, the account pages, and email, and never serves user content.
This applies to every site, claimed or anonymous — claiming removes a site's
expiry, not its address. Site URLs handed out before 2026-09-14 used
<site-id>.flypod.dev and redirect to flypod.page until 2026-12-13.
How do I delete a site?
The CLI has no delete command — flypod forget only clears
the local folder-to-site link. An anonymous site disappears on its own when its
14-day TTL runs out; an owned site can be removed from the signed-in
account page, or with the delete_site tool from
a signed-in chat app.
Comments
Anonymous, anchored comments on flypod sites, including visitor identity, access modes, threaded replies, and current hosted limitations.
Troubleshooting
Match a flypod error code or HTTP status to its cause and fix. Covers auth failures, stale links, expired sites, abuse rejections, size caps, rate limits, and rendering.