Deploy and Host EDGE RUNTIME on Railway

Supabase Edge Runtime is a lightweight, serverless environment optimized for edge function execution. This template provides a ready-to-deploy setup using the official Docker image ghcr.io/supabase/edge-runtime, allowing you to host and scale your Supabase Edge Functions effortlessly via Railway.

About Hosting EDGE RUNTIME

This project enables deployment of Supabase Edge Functions on Railway using a custom Dockerfile and a lightweight runtime based on Deno. With built-in support for webhooks, REST endpoints, and Supabase integration, it's ideal for serverless API logic or background processing tasks. Hosting on Railway ensures fast builds, automatic domain generation, environment variable management, and scalability without server management.

Common Use Cases

• Deploying Supabase Edge Functions as serverless APIs
• Handling webhooks with custom logic
• Creating backend endpoints for lightweight services

Dependencies for EDGE RUNTIME Hosting

• Supabase project (with URL and keys)
• Railway account (to deploy and manage the container)

Deployment Dependencies

• Docker image: ghcr.io/supabase/edge-runtime
• Supabase: https://supabase.com/
• Railway: https://railway.app/

Implementation Details

This project includes several prebuilt functions (main, api-handler, and webhook-processor) and a Dockerfile configured for the Supabase Edge Runtime environment. It also supports environment variables needed for runtime communication with Supabase and Railway.

Supabase Edge Functions Project

This project contains Supabase Edge Functions deployable on Railway using the official Docker image ghcr.io/supabase/edge-runtime.

Project Structure

├── Dockerfile.supabase-edge
├── railway.toml (optional)
├── supabase/
│   └── functions/
│       ├── main/
│       │   └── index.ts
│       ├── api-handler/
│       │   └── index.ts
│       └── webhook-processor/
│           └── index.ts
└── README.md

Deployment on Railway

1. Prepare your repository with the recommended structure.
2. Create the Dockerfile.supabase-edge (already done).
3. Configure environment variables in Railway:
   • SUPABASE_URL
   • SUPABASE_ANON_KEY
   • SUPABASE_SERVICE_ROLE_KEY
   • EDGE_FUNCTION_SECRET
   • HOST="::" (for IPv6 support)
   • PORT="9000"
4. Deploy via Git or GitHub connection.
5. Generate a domain to access your functions.

Why Deploy EDGE RUNTIME on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying EDGE RUNTIME on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.