Edge Function deploy failed due to an internal error

[supabase-search[bot]]

This is a copy of a troubleshooting article on Supabase's docs site. It may be missing some details from the original. View the original article.

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

$ 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:

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