Hexo

This guide shows you how to deploy a Hexo application to Edgio.

Example #

Connector #

Edgio provides a connector for this framework. Learn more.

System Requirements #

• Install Node.js 14.19.0

Sign up for Edgio #

Deploying requires an account on Edgio. Sign up here for free.

Install the Edgio CLI #

If you have not already done so, install the Edgio CLI.

1npm i -g @edgio/cli

Create a new Hexo app #

If you don’t already have a Hexo app, create one by running the following:

1npm install -g hexo-cli
2hexo init blog
3cd blog
4npm install

You can verify your app works by running it locally with:

1hexo server

Configuring your Hexo app for Edgio #

Initialize your project #

In the root directory of your project run edgio init:

1edgio init

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

• The @edgio/core package
• The @edgio/cli package
• The @edgio/hexo package
• edgio.config.js - Contains various configuration options for Edgio.
• routes.js - A default routes file that sends all requests to Hexo. Update this file to add caching or proxy some URLs to a different origin.

Routing #

The default routes.js file created by edgio init sends all requests to Hexo server via a fallback route.

1// This file was added by edgio init.
2// You should commit this file to source control.
3
4const { hexoRoutes } = require('@edgio/hexo')
5const { Router } = require('@edgio/core/router')
6
7export default new Router().use(hexoRoutes)

Running Locally #

To test your app locally, run:

1edgio run

You can do a production build of your app and test it locally using:

1edgio build && edgio run --production

Setting --production runs your app exactly as it will be when deployed to the Edgio cloud.

Deploy to Edgio #

Deploy your app to the Sites by running the following commands in your project’s root directory:

1edgio deploy

Learn more.