Edge Function deploy failed due to an internal error

Last edited: 1/19/2026

When encountering the Function deploy failed due to an internal error, try deploy the function via the Supabase CLI with the --debug flag to gather extra information to identify the possible cause.

You can also try alternative bundle methods:

  • --use-api: Use Management API to bundle functions.
  • --use-docker: Use Docker to bundle functions.

If you're not able to run the CLI or cannot identify the cause, open a support ticket.

Example error

1
$ supabase functions deploy FUNCTION_NAME --project-ref $PROJECT_ID

Example output with --debug

From the details we can see it is exceeding the 20MB Edge Function size limit:

1
$ supabase functions deploy FUNCTION_NAME --project-ref $PROJECT_ID --debug
2
Deploying Function: FUNCTION_NAME (script size: 62.61MB)