wrangler deploy “Missing entry-point”: Deploy a Static dist Directory

First decide: Worker code, static assets, or both#

Wrangler supports three different shapes that are easy to mix up:

The Workers command reference accepts a Worker entry point or a static assets directory. The Static Assets guide shows assets.directory as the place to declare the folder that Wrangler uploads.

This is a deployment-boundary error, not an Astro routing error. Count and inspect the output before changing routes:

1
pnpm build
2
test -d dist
3
find dist -type f | head -20

If the build writes build/, out/, or another directory, replace ./dist with that real output path. A correct command pointed at an empty or non-existent directory still cannot deploy the site you built.

Put a static Astro build in wrangler.jsonc#

For a static-only deployment, use a configuration like this:

1
{
2
  "$schema": "./node_modules/wrangler/config-schema.json",
3
  "name": "my-static-site",
4
  "compatibility_date": "2026-08-19",
5
  "assets": {
6
    "directory": "./dist"
7
  }
8
}

Run the build before deployment:

1
pnpm build
2
pnpm exec wrangler deploy

If the project has a Worker that handles API routes or request-time rendering, add its entry point rather than removing the code that needs to run:

1
{
2
  "$schema": "./node_modules/wrangler/config-schema.json",
3
  "name": "my-worker-site",
4
  "main": "src/index.ts",
5
  "compatibility_date": "2026-08-19",
6
  "assets": {
7
    "directory": "./dist"
8
  }
9
}

Do not copy a pages_build_output_dir setting from a Cloudflare Pages project into a Workers Static Assets configuration. The Cloudflare Pages file-limit guide explains the product distinction and the separate migration decision. assets.directory is the Workers configuration boundary.

Diagnose CI-specific missing entry points#

The same repository can work locally and fail in CI when the build runs in one directory while Wrangler looks for configuration in another. Log the inputs that determine the deployment:

1
pwd
2
pnpm exec wrangler --version
3
test -f wrangler.jsonc && sed -n '1,160p' wrangler.jsonc
4
pnpm build
5
find dist -maxdepth 2 -type f | head -20
6
pnpm exec wrangler deploy

Check these boundaries in order:

1. The job is running from the package that owns the Wrangler config.
2. The build command completed before wrangler deploy started.
3. The configured asset directory exists in the CI filesystem.
4. The CI checkout includes the configuration and generated output.
5. The deployed project uses the same config variant and environment as the local command.

If the configuration is generated or stored outside the working directory, pass the intended config explicitly using the Wrangler option supported by the installed CLI rather than relying on the current directory. Keep the final command in CI visible enough that a missing path is diagnosable from the log.

Cloudflare’s build troubleshooting guide describes the same missing-entry-point failure and points to the project root and configuration file as first checks. The Workers SDK issue #10563 is useful as a symptom reference, but your project’s actual output path remains the decisive evidence.

Verify the deployed shape#

After the command succeeds, test one request for each kind of output:

• an HTML page generated into dist/;
• a CSS or JavaScript asset;
• a missing URL that should return the intended 404 behavior;
• a Worker route, if main is configured;
• an API or binding-backed route, if the site is not purely static.

Do not infer SSR support from a successful asset upload. A static asset deployment can serve a polished site while still lacking request-time sessions, bindings, or API execution. The existing Astro Cloudflare session binding guide covers the separate case where an Astro Worker needs a KV binding.

The practical fix is to make the deployment shape explicit. Give Wrangler a Worker entry when code must execute, give it the directory that actually contains the static build when it does not, and keep the same configuration visible to local commands and CI.

FAQ#