Deploy Vendure to Digital Ocean

If you'd like to quickly get started with a ready-made Vendure project which includes sample data, you can clone our Vendure one-click-deploy repo.

Configuration

Database connection

Make sure your DB connection options uses the following environment variables:

Asset storage

Since App Platform services do not include any persistent storage, we need to configure Vendure to use Digital Ocean's Spaces service, which is an S3-compatible object storage service. This means you'll need to make sure to have the following packages installed:

npm install @aws-sdk/client-s3 @aws-sdk/lib-storage

and set up your AssetServerPlugin like this:

Create Spaces Object Storage

First we'll create a Spaces bucket to store our assets. Click the "Spaces Object Storage" nav item and create a new space and call it "vendure-assets".

Next we need to create an access key and secret. Click the "API" nav item and generate a new key.

Name the key something meaningful like "vendure-assets-key" and then make sure to copy the secret as it will only be shown once. Store the access key and secret key in a safe place for later - we'll be using it when we set up our app's environment variables.

Create the server resource

Now we're ready to create our app infrastructure! Click the "Create" button in the top bar and select "Apps".

Now connect to your git repo, and select the repo of your Vendure project.

Depending on your repo, App Platform may suggest more than one app: in this screenshot we are using the one-click-deploy repo which contains a Dockerfile, so App Platform is suggesting two different ways to deploy the app. We'll select the Dockerfile option, but either option should work fine. Delete the unused resource.

We need to edit the details of the server app. Click the "Edit" button and set the following:

• Resource Name: "vendure-server"
• Resource Type: Web Service
• Run Command: node ./dist/index.js
• HTTP Port: 3000

At this point you can also click the "Edit Plan" button to select the resource allocation for the server, which will determine performance and price. For testing purposes the smallest Basic server (512MB, 1vCPU) is fine. This can also be changed later.

Add a database

Next click "Add Resource", select Database and click "Add", and then accept the default Postgres database. Click the "Create and Attach" to create the database and attach it to the server app.

Your config should now look like this:

Set up environment variables

Next we need to set up the environment variables. Since these will be shared by both the server and worker apps, we'll create them at the Global level.

You can use the "bulk editor" to paste in the following variables (making sure to replace the values in <angle brackets> with your own values):

After saving your environment variables you can click through the confirmation screens to create the app.

Create the worker resource

Now we need to set up the Vendure worker which will handle background tasks. From the dashboard of your newly-created app, click the "Create" button and then select "Create Resources From Source Code".

You will be prompted to select the repo again, and then you'll need to set up a new single resource with the following settings:

• Resource Name: "vendure-worker"
• Resource Type: Worker
• Run Command: node ./dist/index-worker.js

Again you can edit the plan, and the smallest Basic plan is fine for testing purposes.

No new environment variables are needed since we'll be sharing the Global variables with the worker.

Enable access to the required routes

To be able to access the UI and other routes, we need to declare them first.

1. In the app dashboard, click on the Settings tab.

2. Click on the vendure-server component.

   

3. Scroll down to HTTP Request Routes.

4. Click on Edit.

5. Click on + Add new route and fill in the form like this:

   

6. Make sure to check the Preserve Path Prefix option.

You need to do this for the following routes:

• /admin
• /assets
• /health
• /admin-api
• /shop-api

7. Click on Save.

Test your Vendure server

Once everything has finished deploying, you can click the app URL to open your Vendure server in a new tab.