Files
supabase/apps/docs/content/troubleshooting/edge-function-fails-deploy.mdx
github-actions[bot] 9f07af03e4 [bot] sync troubleshooting guides to db (#40100)
* fix(troubleshooting sync)

A few troubleshooting guides aren't syncing properly, for miscellaneous
issues:

- Misformatted link
- Edge cases with Markdown parsing:
  - GFM automatically wraps emails in angle brackets, which subsequently
breaks MDX because it expects anything wrapped in angle brackets to be a
JSX tag
  - toMarkdown inserts sentinel comments between certain blocks, which
subsequently breaks MDX for the same reason

* [bot] sync troubleshooting guides to db

* Update apps/docs/content/troubleshooting/converted-github-account-to-organisation---lost-supabase-account-access-5wsE_1.mdx

* Update apps/docs/content/troubleshooting/new-branch-doesnt-copy-database.mdx

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

---------

Co-authored-by: Charis Lam <26616127+charislam@users.noreply.github.com>
Co-authored-by: github-docs-sync-bot <github-docs-sync-bot@supabase.com>
Co-authored-by: Chris Chinchilla <chris.ward@supabase.io>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-01-19 03:35:39 +00:00

39 lines
1.3 KiB
Plaintext

---
title = "Edge Function deploy failed due to an internal error"
topics = [ "functions" ]
keywords = [ "fail", "deploy" ]
database_id = "30b3f7a4-a2b7-4430-8176-31aa4d92b2e9"
[[errors]]
http_status_code = 500
message = "Function deploy failed due to an internal error"
[[errors]]
http_status_code = 500
message = "unexpected deploy status 500"
---
When encountering the `Function deploy failed due to an internal error`, try deploy the function via the [Supabase CLI](/docs/guides/local-development) with the `--debug` flag to gather extra information to identify the possible cause.
You can also try [alternative bundle methods](/docs/reference/cli/supabase-functions-deploy):
- `--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](/dashboard/support/new).
**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](/docs/guides/functions/limits):
```
$ supabase functions deploy FUNCTION_NAME --project-ref $PROJECT_ID --debug
Deploying Function: FUNCTION_NAME (script size: 62.61MB)
```