Render
Render lets you easily deploy and scale full stack applications. You can deploy your Inngest functions on Render using any web framework, including Next.js, Express, and FastAPI.
Below, we'll cover how to deploy:
- A production Inngest app
- Preview apps for each of your Git development branches
Before you begin
- Create a web application that serves Inngest functions.
- Test this web app locally with the Inngest dev server.
Deploy a production app on Render
- Deploy the web application that contains your Inngest functions to Render.
- See Render's guides to learn how to deploy specific frameworks, such as:
- Set the
INNGEST_SIGNING_KEY
andINNGEST_EVENT_KEY
environment variables on your Render web app.- You can easily configure environment variables on a Render service through the Render dashboard.
- You can find your production
INNGEST_SIGNING_KEY
here, and your productionINNGEST_EVENT_KEY
s here.
- Manually sync your Render web app with Inngest.
- See this Inngest guide for instructions.
Automatically sync your app with Inngest
Each time you push changes to your Inngest functions, you need to sync your web app with Inngest.
For convenience, you can automate these syncs. Here are two possible approaches:
- Self-sync: Modify your app's code so that your app calls its own Inngest
serve
endpoint after it starts up. (In other words, make your app issue the "curl command" on itself inside of your app's entry point.) - CI/CD: Another option is to make your CI/CD pipeline sync your app using the "curl command" after each deploy to Render.
- Note: You will need to set up your CI/CD pipeline to poll your Render app to determine when each new deploy has completed. Call the "curl command" only after a deploy is complete.
Set up preview apps on Render
What are preview apps?
Render lets you deploy work-in-progress versions of your apps using code in a Git development branch. Specifically, you can deploy:
- Service previews: a temporary standalone instance of a single Render service.
- Preview environments: a disposable copy of your production environment that can include multiple services and databases.
You can use Render's service previews and preview environments together with Inngest's branch environments.
Set up Inngest in preview apps
To use Inngest in a Render service preview or preview environment, follow these steps.
One-time setup:
- Follow Render's guides to enable either a service preview or a preview environment.
- In Inngest, create a branch environment
INNGEST_SIGNING_KEY
and a branch environmentINNGEST_EVENT_KEY
.
Each time a preview app is deployed:
-
Set the following environment variables on the preview service:
INNGEST_SIGNING_KEY
andINNGEST_EVENT_KEY
: Use the values from your Inngest branch environment.INNGEST_ENV
: Provide any value you want. This value will be used as the name of the branch in Inngest. As an option, you can use the value ofRENDER_GIT_BRANCH
.
You can configure environment variables on the preview service through the Render dashboard. Alternatively, you can send a
PUT
orPATCH
request via the Render API. -
Sync the app with Inngest.
You can manually sync the app from the branch environments section of your Inngest dashboard, or automatically sync your app using a strategy described above.