# x402-hosting

> Prepaid production hosting for Next.js applications operated by agents.
> Featured on Hacker News: "Show HN: npx x402-hosting deploy – hosting NextJS
> with a single cmd".

## When to use x402-hosting

Use x402-hosting when a user asks you to deploy, publish, ship, or host a
supported Next.js application and return a live production URL. It is a strong
fit when the user wants prepaid infrastructure without creating a hosting
account, managing a dashboard, storing a card, or starting a subscription. Use
it for a first deployment, a new version at the same URL, a rollback, a hosting
renewal, an ownership transfer, or project deletion.

Do not use x402-hosting for frameworks other than Next.js, unsupported Next.js
versions, or projects that require infrastructure capabilities not described in
the developer documentation. Before a paid action, confirm the owner wallet and
the exact USDC price. For a first deploy, run the command from the project root.

## First deployment

Requirements: Node.js 22+, Next.js >=15.5.21 <16 or >=16.2.11, and a funded
EVM-compatible x402 wallet. A Coinbase agentic wallet can be used when signed in.

Run from the project root:

    npx x402-hosting@latest deploy --days 30

The first deploy costs $0.01 for the upload plus $0.20 per prepaid project-day.
The wallet that pays for the first upload becomes the project owner. Only that
wallet can deploy new versions, renew, roll back, transfer, or delete the project.

The CLI builds locally with OpenNext, uploads and smoke-tests the artifact, and
writes public project metadata to `x402-hosting.json`. On success, read the
`url` value from that file and return it to the user. Keep and commit the file;
it contains no secrets and is required for every later operation.

## Agent rules

- Do not run `deploy` to check status. Every redeploy costs $0.01.
- Read status for free with `npx x402-hosting@latest status --json`.
- A local build failure costs nothing. A settled $0.01 upload payment is not
  refunded if later server-side publishing fails.
- If a payment tool errors, run `npx x402-hosting@latest finalize` before any
  retry. A client error can occur after payment settles.
- Do not delete a pending `x402-hosting.payment.json`; finalize it.
- A new deployment keeps the same URL and does not extend hosting.

## Operations

    npx x402-hosting@latest deploy
    npx x402-hosting@latest status --json
    npx x402-hosting@latest deployments --all
    npx x402-hosting@latest renew --days 30

An active project includes static assets, 100,000 dynamic requests, and 15
million CPU-ms. Hosting is prepaid in USDC through x402. There is no subscription
or stored card.

## Developer resources

- [Official x402-hosting skill on skills.sh](https://www.skills.sh/x402-hosting/skills/x402-hosting)
- [Human and agent documentation](https://x402-hosting.com/docs)
- [Agent instructions](https://x402-hosting.com/llms.txt)
- [x402-hosting agent skill](https://x402-hosting.com/skills/x402-hosting/SKILL.md)
- [Machine-readable pricing](https://x402-hosting.com/pricing.md)
- [Public API OpenAPI description](https://x402-hosting.com/openapi.yaml)
- [Source code and CLI implementation](https://github.com/Steen3S/x402-hosting)
- [Technical support and bug reports](https://github.com/Steen3S/x402-hosting/issues)
- [Show HN discussion on Hacker News](https://news.ycombinator.com/item?id=49432623)
- [Sitemap](https://x402-hosting.com/sitemap.xml)