You can use this repository as a jumping off point for deploying a self-hosted version of on Render using the public docker image located at

Fork the repository mentioned above and change the app name

You should fork the repository before starting so you can make changes and commit them. For example, in render.yaml file you’ll need to change the name under services to a unique name for your app.

Create a new web service

  1. Go to the Render dashboard.

  2. Click on “New” in the top right corner.

  3. Choose “Web service”

    new web service render

  4. Click on “Connect With GitHub” (if you have not already done so). You will need to authorize Render to access your GitHub repositories.

  5. Once connected, you will see a list of your repositories. Choose the repository that contains your project.

  6. Render will detect the render.yaml file in your repository and auto fill the fields, add your app name now.

    add app name render

  7. Scrolldown, click on advanced. Here you will need to add the environment variables

    advanced render

Gather your secret environment variables

The process for generating and collecting the required environment variables is identical to the one described in the guide. Follow the steps there to generate and collect the required environment variables.

Set the environment variables

The render.yaml file declares several environment variables that your app needs to run. These include the ENCRYPTION_KEY, MAGIC_LINK_SECRET and SESSION_SECRET, and others. You need to manually set the values of these environment variables in the Render dashboard:

  1. Click on “Add Environment Variable” to add a new environment variable.
  2. Enter the key and value for each environment variable declared in your render.yaml file. The key should match the name of the environment variable in the render.yaml file. add env variables render


Render automatically deploys your service when you push to the connected GitHub repository. Alternatively, you can manually trigger a deployment from the Render dashboard by clicking “Deploy” in the “Deploys” tab.

Initialize your Next.js project

Next, you can easily bootstrap your Next.js project to use your self-hosted instance of

First, cd into your Next.js project, then run the init command to initialize your Next.js project:

npx init -t "https://<your render app name>"

When it asks for your development API key, head over to your self-hosted dashboard and select the initial project you created when signing up, and head to the Environments & API Keys page to copy your dev SERVER API key:

api key

Start your dev server

Run your Next.js project dev server with npm run dev and then in a new terminal window you will need to run the dev command to connect to your instance and allow it to tunnel to your local Next.js server:

npx dev

At this point you should be able to navigate to your dashboard and view your registered jobs