{"record":{"id":"32097183d72c4648","repo":"withastro/astro","slug":"the-adapter-adapter-name-does-not-support-emitt","errorCode":null,"errorMessage":"The adapter ${adapter.name} does not support emitting a server output, but the project contain server-rendered pages. Your project will not build correctly.","messagePattern":"The adapter (.+?) does not support emitting a server output, but the project contain server-rendered pages\\. Your project will not build correctly\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"packages/astro/src/core/dev/adapter-validation.ts","lineNumber":44,"sourceCode":") {\n\tif (settings.adapter && settings.adapter.name !== adapter.name) {\n\t\tthrow new Error(\n\t\t\t`Integration \"${maybeConflictingIntegration}\" conflicts with \"${settings.adapter.name}\". You can only configure one deployment integration.`,\n\t\t);\n\t}\n\n\tif (settings.buildOutput === 'server' && adapter.adapterFeatures?.buildOutput === 'static') {\n\t\t// If the adapter is not compatible with the build output, throw an error\n\t\tif (command === 'build') {\n\t\t\tconst adapterRecommendation = getAdapterStaticRecommendation(adapter.name);\n\n\t\t\tthrow new AstroError({\n\t\t\t\t...AstroErrorData.AdapterSupportOutputMismatch,\n\t\t\t\tmessage: AstroErrorData.AdapterSupportOutputMismatch.message(adapter.name),\n\t\t\t\thint: adapterRecommendation ? adapterRecommendation : undefined,\n\t\t\t});\n\t\t} else if (command === 'dev') {\n\t\t\tlogger.warn(\n\t\t\t\tnull,\n\t\t\t\t`The adapter ${adapter.name} does not support emitting a server output, but the project contain server-rendered pages. Your project will not build correctly.`,\n\t\t\t);\n\t\t}\n\t}\n\n\tif (adapter.entrypointResolution === undefined) {\n\t\tlogger.warn(\n\t\t\tnull,\n\t\t\t`The adapter ${adapter.name} uses \\`entrypointResolution: \"explicit\"\\` by default, which is deprecated and will be removed in a future major version.`,\n\t\t);\n\t\tlogger.warn(\n\t\t\tnull,\n\t\t\t'Update your adapter to use \\`entrypointResolution: \"auto\"\\` or contact the maintainers to update.',\n\t\t);\n\t}\n}\n","sourceCodeStart":26,"sourceCodeEnd":62,"githubUrl":"https://github.com/withastro/astro/blob/52e6c34790cc8ac4e69e6135ace06049867e5c4a/packages/astro/src/core/dev/adapter-validation.ts#L26-L62","documentation":"The configured adapter declares adapterFeatures.buildOutput === 'static' — it can only produce static output — while the project contains server-rendered routes. In `astro dev` this logs the warning; the identical condition during `astro build` throws the AdapterSupportOutputMismatch error instead.","triggerScenarios":"A static-only adapter combined with settings.buildOutput === 'server' (output: 'server' or prerender = false pages), while running the dev server.","commonSituations":"Using a static/host-specific adapter and later adding API routes or SSR pages; upgrading an adapter whose declared features changed.","solutions":["Switch to an SSR-capable adapter (e.g. @astrojs/node) that supports server output","Or make the project static: prerender all pages and use output: 'static'","Or remove the server-rendered routes that force server output"],"exampleFix":"// before — static-only adapter with server routes\nimport staticAdapter from 'some-static-adapter';\nexport default defineConfig({ output: 'server', adapter: staticAdapter() });\n\n// after — SSR-capable adapter\nimport node from '@astrojs/node';\nexport default defineConfig({\n  output: 'server',\n  adapter: node({ mode: 'standalone' }),\n});","handlingStrategy":"validation","validationCode":"// invariant: adapter capability must match build output\nconst adapter = config.adapter;\nif (adapter?.adapterFeatures?.buildOutput === 'static' && config.output === 'server') {\n  throw new Error(`${adapter.name} cannot emit server output`);\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Match adapter capabilities to your routing model before adding SSR pages","Prefer failing on `astro build` in CI over relying on the dev warning","Check the adapter's declared buildOutput support when upgrading it"],"tags":["adapter","ssr","build-output","static"],"backgroundTag":"adapter-build-output-mismatch","analyzedSha":"52e6c34790cc8ac4e69e6135ace06049867e5c4a","analyzedAt":"2026-08-18T18:48:03.901Z","contentChangedAt":"2026-08-18T18:48:03.901Z","schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}