Updated

Issues serving Edge Functions locally

If supabase functions serve fails or you’re having trouble running Edge Functions locally, follow these steps to diagnose and resolve the issue.

Debugging steps

Use debug mode

Run the serve command with the --debug flag for detailed output:

supabase functions serve your-function --debug

Check port availability

Ensure the required ports are available. The Supabase CLI uses ports 54321 and 8081 by default:

# Check if port 54321 is in use
lsof -i :54321
# Check if port 8081 is in use
lsof -i :8081

If these ports are in use, stop the processes using them or configure different ports.

Common issues

Port conflicts

Another process may be using the required ports. Check for:

  • Other Supabase projects running locally
  • Docker containers
  • Other development servers

If the conflict comes from another Supabase project, run both projects at the same time with the experimental supabase stack commands. They assign each local project its own ports. Turn on the commands and remove the fixed ports from each project’s config.toml first. See Running multiple local projects.

Deno cache issues

Clear the Deno cache if you’re experiencing module resolution problems:

deno cache --reload /path/to/function/index.ts

Environment variables

Make sure your .env file is properly configured and accessible to the CLI.

Getting more help

If the problem persists, search the following repositories for similar error messages:

If the output from these commands does not help resolve the issue, open a support ticket via the Supabase Dashboard (by clicking the “Help” button at the top right) and include all output and details about your commands.

Additional resources

AI tools

Connect your AI agentAsk ChatGPTAsk Claude

Go to the GitHub discussion