Skip to main content

Preview: Vendure Core (feat/core-telemetry-v2) | Vendure Docs

Deploy Vendure to Render

Render is a managed hosting platform which allows you to deploy and scale your Vendure server and infrastructure with ease.

Note

The configuration in this guide will cost from around $12 per month to run.

Prerequisites

First of all you'll need to create a new Render account if you don't already have one.

For this guide you'll need to have your Vendure project in a git repo on either GitHub or GitLab.

Info

If you'd like to quickly get started with a ready-made Vendure project which includes sample data, you can use our Vendure one-click-deploy repo, which means you won't have to set up your own git repo.

Configuration

Port

Render defines the port via the PORT environment variable and defaults to 10000, so make sure your Vendure Config uses this variable:

src/vendure-config.ts

import { VendureConfig } from '@vendure/core';export const config: VendureConfig = {    apiOptions: {        port: +(process.env.PORT || 3000), // [!code highlight]        // ...    },    // ...};

Database connection

src/vendure-config.ts

import { VendureConfig } from '@vendure/core';export const config: VendureConfig = {    // ...    dbConnectionOptions: {        // ...        database: process.env.DB_NAME,        host: process.env.DB_HOST,        port: +process.env.DB_PORT,        username: process.env.DB_USERNAME,        password: process.env.DB_PASSWORD,    },};

src/vendure-config.ts

import { VendureConfig } from '@vendure/core';import { AssetServerPlugin } from '@vendure/asset-server-plugin';export const config: VendureConfig = {    // ...    plugins: [        AssetServerPlugin.init({            route: 'assets',            assetUploadDir: process.env.ASSET_UPLOAD_DIR || path.join(__dirname, '../static/assets'), // [!code highlight]        }),    ],    // ...};

Bash

DB_NAME=<database "Database">DB_USERNAME=<database "Username">DB_PASSWORD=<database "Password">DB_HOST=<database "Hostname">DB_PORT=<database "Port">ASSET_UPLOAD_DIR=/vendure-assetsCOOKIE_SECRET=<add some random characters> # [!code highlight]SUPERADMIN_USERNAME=superadminSUPERADMIN_PASSWORD=<create some strong password> # [!code highlight]