This guide shows you how to deploy an Gatsby application on the Moovweb XDN:

Install Node.js and npm

XDN only supports Node.js version 12 and higher

If you do not have Node.js installed on your system, download and install it from official Node.js downloads page. Select the download labeled "LTS (Recommended For Most Users)" and that matches your operating system, and run the installer. Note that the installer for Node.js will also install npm.

Getting Started

If you don't already have a Gatsby application, you can create one using:

npm install -g gatsby-cli
gatsby new gatsby-site

You should now have a working Gatsby site. Run gatsby serve to see the application running on localhost:8000.

To deploy your Gatsby on Moovweb XDN:

  1. Install the XDN CLI globally:
npm install -g @xdn/cli
  1. Run xdn init

This will automatically add all of the required dependencies and files to your project. These include:

  • The @xdn/core package
  • The @xdn/gatsby package
  • The @xdn/cli package
  • xdn.config.js
  • routes.js - A default routes file that sends all requests to your Gatsby static site. Update this file to add caching or proxy some URLs to a different origin.

Running Locally

You can test the integration of the XDN router with your gatsby site locally using:

xdn run


To deploy your app to the Moovweb XDN, run:

xdn deploy

See deploying for more information.


The default routes.js file created by xdn init sends all requests to the Gatsby static site.

// This file was automatically added by xdn deploy.
// You should commit this file to source control.

const { Router } = require('@xdn/core/Router')
const { gatsbyRoutes } = require('@xdn/gatsby')

module.exports = new Router().use(gatsbyRoutes)

Adding routes to a different origin

To proxy some URLs to a different origin, you need first to configure that origin in your xdn.config.js file.

For example:

// xdn.config.js

module.exports = {
  backends: {
    legacy: {
      domainOrIp: process.env.LEGACY_BACKEND_DOMAIN || '',
      hostHeader: process.env.LEGACY_BACKEND_HOST_HEADER || '',

Using environment variables here allows you to configure different legacy domains for each XDN environment.

Then you can add routing and caching rules to your routes.js file. Note that gatsbyRoute must be declared last as it acts as a fallback route.

For example:

// routes.js

const { Router } = require('@xdn/core/Router')
const { gatsbyRoutes } = require('@xdn/gatsby')

module.exports = new Router()
  .get('/some/legacy/url/:p', ({ proxy }) => {

Check routing and caching for more information.