Gatsby on the Edge in under 2 minutes with Fastly

Did you know you can easily serve static sites from the edge with Fastly? Here’s how to get a Gatsby site published on Fastly’s Compute for free in less than 2 minutes.

Quick background

What is Gatsby, and why would you want to put it on Compute? 

Gatsby is an open source framework that allows you to create websites using React. There are a number of pros to Gatsby and the Jamstack approach in general, including performance, scalability, and security.

Compute allows you to deploy and run logic for any application or backend service on Fastly’s Edge platform. That means you get the benefits of serverless computing being delivered even closer to the end-user, with no cold starts or roundtrip delays — it’s super fast.

By deploying a Gatsby site (or any site) to Compute, you can create fantastic end-user experiences, like providing instant language localization, serving localized content, and much more – all without having to manage the underlying infrastructure! 

Let’s get started


First, in your terminal, run npm init gatsby. This will take you into an interactive prompt with options to name your site, specify a folder to create, choose whether to use JavaScript or TypeScript, etc. 

gatsby blog image 1

Next, navigate into your newly minted project by running cd [your-project-name]. For my example, I can run cd gatsby-on-compute. (I won’t go over the specifics of Gatsby, but if you’re interested in learning more about how Gatsby works, check out their tutorial.)

Now that you’re in your project’s directory, go ahead and build the site by running npm run build. This will produce a ./public folder with all of your built static files (like HTML, CSS, vanilla JS, and images). 

Now that we have our project’s build complete, run npx @fastly/compute-js-static-publish --public-dir=./public --service-id="". This uses Fastly’s Static Publisher for JavaScript to generate a Compute application in a new directory that can be found in  ./compute-js. It also points to your build by using the —public-dir=./public. If you look in your new fastly.toml file that was created, you’ll see that service_id is set to ””. If you already have a Compute service you want to use, you can fill in the ID here. Otherwise, leave it as an empty string and the Fastly CLI will create a new service for you and fill it in like magic.

gatsby blog image 2

Next, let’s cd ./compute-js and run fastly compute publish. This will run the build and then provide an interactive prompt helping you create a new service, allow you to change the default random domain, and add a backend (if needed). With Static Publisher, we don’t need to use or configure a backend, so we can just accept the defaults here.

Once it’s done creating the service and domain, uploading the package, and activating the version – you’re up and running! You can view the newly created service or manage it with the links provided. See this one LIVE here.

Gatsby blog image 3

Want to publish to Compute using other frontend frameworks? Stay tuned for upcoming articles!

Jonathan Speek
Senior Product Manager

3 min read

Want to continue the conversation?
Schedule time with an expert
Share this post
Jonathan Speek
Senior Product Manager

Jonathan is a Senior Product Manager at Fastly focused on enhancing the product experience. Prior to Fastly, Jonathan was a Senior Software Engineer at Netlify working on the core product UI and growth. Prior to working in tech, Jonathan was a classical musician, having performed in venues ranging from Carnegie Hall to NFL stadiums, and even a raft in Lake Michigan.

Ready to get started?

Get in touch or create an account.