Render

​

Overview

Render is a Platform as a Service that makes deploying and hosting Spree applications super easy.

Spree Starter is pre-configured to work with Render out of the box. It includes render.yaml file that is used to deploy the application.

​

Prerequisites

• Render account - you will also need to add a credit card to your Render account to be able to deploy the application.
• GitHub account

​

Setup repository

Firstly create your own repository based on Spree Starter template.

Go to Spree Starter repository and click on “Use this template” button and select “Create a new repository”.

Supply the repository name and click on “Create repository from template” button.

Now clone the repository to your local machine.

git clone https://github.com/your-username/my_spree_app.git

Now you can start working on your application. Make sure your environment is set up correctly (follow the Getting Started guide).

Running the bin/setup script should set your SECRET_KEY_BASE environment variable correctly in the .env file.

​

Create Render account and connect your repository

Go to render.com and create an account. We recommend to use your GitHub account to sign up as it will automatically link your GitHub repositories to Render.

​

Create Render blueprint

Render blueprints are YAML files used to deploy your application to Render. They consist a list of services that are required to run your application.

In the Render dashboard select “New blueprint” from the “+New” button.

Now select your repository from the list of repositories.

You should see the the new blueprint form.

1. Set your blueprint name - eg. Spree App

2. Generate a new SECRET_KEY_BASE value.

   bin/rails secret
   

3. Paste it to the SECRET_KEY_BASE environment variable for both web and worker services (it needs to be the same value for both).

After that is done click the “Deploy Blueprint” button. Now wait a few minutes for Render to setup your application.

You should see the following screen with the list of created services.

That’s it! Your application is now deployed to Render.

You can now access the admin dashboard of your application at the following URL.

https://<your-application-name>.onrender.com/admin

The default credentials are:

Email: [email protected]
Password: password

Spree::User.first.update!(email: "<[email protected]>", password: "<your_password>", password_confirmation: "<your_password>")

​

Next steps

Now that your application is deployed, you also need to setup asset storage as Render only provides ephemeral storage.

• Setup Asset storage (Amazon S3/Cloudflare R2)

Before going to full production, we recommend to also:

• Setup CDN
• Configure Caching