# Next.js hosting for static builds

> Deploy static Next.js exports generated with output export or another static export workflow.

Canonical: https://staticx.site/nextjs-hosting

## Deploy static exports

StaticX hosts the out folder created by a static Next.js export workflow.

## Know what export excludes

SSR, middleware, ISR, server actions, and API routes are not part of a plain static export.

## Keep Next iterations versioned

Each exported build can become a StaticX release with domain, analytics, forms, and rollback context.

## Host a static Next.js export

Configure Next.js for static output, build/export the out folder, and publish those files to StaticX.

1. **Enable static output** — Use a Next.js configuration that writes static pages and assets into out.
2. **Check unsupported routes** — Remove or replace server-only features before uploading the export.
3. **Deploy the out contents** — Publish the contents of out with index.html and route files visible at the expected paths.

## Next.js hosting depends on whether the site can be exported.

Next.js can produce a static website, but not every Next.js feature survives static export. Pages that need runtime rendering must use a server-capable platform.

When the project can export cleanly, StaticX is a durable hosting layer for the generated files, with version analytics and rollback around each release.

## Next.js export checks

- **Images and assets** — Configure image handling so exported pages reference files that exist in the output folder.
- **Dynamic routes** — Pre-render dynamic paths or avoid routes that require runtime generation.
- **No API routes** — Move API behavior to an external backend before deploying the static export.

## FAQ

### Can StaticX host Next.js SSR?

No. StaticX hosts static exports. SSR, middleware, ISR, and API routes require a runtime host.

### Which Next.js folder should I upload?

Upload the contents of the out folder produced by static export.

### Can exported Next.js pages use custom domains?

Yes. Custom domains apply to the StaticX site after the static export is published.

### Can AI agents deploy a Next.js export?

Yes, if they build/export, verify out, deploy the output root, and return the live URL or exact error.

[View on staticx.site](https://staticx.site/nextjs-hosting)