Deploying to a DigitalOcean Droplet
This guide walks through how to deploy and host your Gatsby site on a DigitalOcean Droplet with Ubuntu and Nginx.
DigitalOcean provides a cloud platform to deploy, manage, and scale applications of any size, removing infrastructure friction and providing predictability so developers and their teams can spend more time building better software.
DigitalOcean’s product droplets are scalable compute IaaS (Infrastructure as a Service) or a VPS (Virtual Private Server) on the cloud which has great reliability and scalability. They come with varied price ranges ideal for small apps to giant enterprise-level apps.
They provide service to select from various Unix-based distributions and select your technology-based platform with preinstalled pre-requisites from the marketplace. This guide will walk through the specific options that work best for deploying a Gatsby site with DigitalOcean.
A Droplet can be spun up in less than a minute for as little as \$5/month.
- A Gatsby site living in a Git repository (GitHub, GitLab, or any Git cloud)
- A DigitalOcean Droplet with a non-root user configured with
sudogroup (example: Ubuntu 18.04)
- A custom domain name for your Gatsby site to help with configuring HTTPS
Follow these instructions for installs on an Ubuntu droplet.
Log in to your droplet as a non-root user.
To view the version of Node.js and npm installed, run,
To install the latest stable Node.js release using the
Note: If you check the version now, you would see the older versions of Node.js and npm from the cache. You can either exit and restart your terminal or refresh the cache by running the following commands:
Install the Gatsby CLI globally. This will be useful ahead in building the Gatsby site for production.
The next step is to clone the repository containing your Gatsby app (Replace
<your-github-repo-site> with your GitHub repository link)
Note: Copy the path where your
<your-github-repo-site>is cloned, for future reference.
In case of a warning related to “Permission denied”, check if
<your non-root user> has
sudo privileges. Or before cloning your repository, change permissions for
<your non-root user> to access the
.config directory of under
/home/<your non-root user>/:
Note: This guide will refer to the cloned directory as
<my-gatsby-app>for simplicity; you should replace it with your repo directory name.
The static files will be hosted publicly on the droplet. The
gatsby build command provides utility to build the site and generate the static files in the
Note: Go to the path where
<my-gatsby-app>is. You can used the copied path for reference in a previous step.
- Install dependencies.
- Run build to generate static files.
To host a website or static files onto a Linux-based server/VPS, a web-server like Apache or Nginx is required.
Nginx is web-server. It provides the infrastructure code for handling client requests from the World Wide Web, along with features like a load balancer, mail proxy, and HTTP Cache.
Configure firewall settings of the droplet to listen to HTTP and HTTPS requests on port 80 and 443 respectively.
Note: You may have to allow access to port 443 explicitly using
sudo ufw allow 443/tcp.
To check the access,
ufwstatus is disabled/inactive, you can enable it with the following command:
Allow the OpenSSH if not already done, to not disconnect from your droplet.
Change the root directory configuration of Nginx in the default server block file
Open the file
defaultin Vim (shortcut cheat sheet)
Edit the file and make the following changes for below-mentioned fields, leave the rest of the fields as is. Your exact path may vary, but it may resemble
/home/<your non-root user>/<my-gatsby-app>/public.
Restart the Nginx service
You should now be able to view your built Gatsby site at your DigitalOcean IP address, before configuring a domain.
Configure your domain to point to the IP address of your droplet. Go to the Advanced DNS settings in your domain provider’s console and put an
Arecord that points to the IP address of the droplet.
By this time, you can view your site live at
Follow the below steps to configure your site with a free SSL/TLS certificate from Lets Encrypt using their Certbot CLI tool.
Install Certbot onto your droplet.
You’ll need to add the Certbot PPA (Personal Package Archives) to your list of repositories. To do so, run the following commands:
Run the following commands to install Certbot.
Generate the certificate. Certbot will automatically edit and configure the Nginx config file and point to the certificate file.
Run the following command:
If you are using Certbot for the first time on this droplet then you will be prompted to enter your e-mail for recovery purposes.
Agree to the license agreement on prompt.
Note: You will be prompted to select the domain for which you want to generate the certificate. Select the domain configured in a previous step.
Note: You will be prompted to choose the option to redirect HTTP requests to HTTPS, which you may choose on your needs. (It is recommended to choose to redirect HTTP to HTTPS)
Restart the Nginx service.
Now, you can access your site at
<your-domain>with a secure connection.
Once you’ve followed along with all the steps and configuration properly, you can visit your site live at
Whenever there’s an update to your site, run a
sudo gatsby build in the root of your
<my-gatsby-app> and your changes will be live.
Congratulations! You’ve deployed your Gatsby App on a DigitalOcean droplet along with configuring HTTPS for it.
There’s a lot more to learn about DigitalOcean’s Droplets, Ubuntu configurations, and Nginx. Below are some links which could be useful in achieving the prerequisites of this post: