This is an example of how to set up a static site with Docusaurus on Kinsta’s Application Hosting services.

Docusaurus is a static-site generator. It builds a single-page application with fast client-side navigation, leveraging the full power of React to make your site interactive. It is designed to make it easy for teams to publish documentation websites without having to worry about the infrastructure and design details. At its core, all a user has to provide are documentation files written in Markdown, customization of a provided home page written in React, and a few configuration modifications.

During the deployment process, Kinsta automatically installs dependencies defined in your package.json file.

  1. Fork this GitHub repository: Kinsta – Hello World – Docusaurus
  2. In MyKinsta, add an application with the Hello World Docusaurus repository. The Start command can be left blank for the web process as Kinsta automatically detects the required command during the first deployment.

The app is available as soon as the build finishes and a default Docusaurus My Site page loads at your application’s URL.

Docusaurus default My Site page after successful installation.
Docusaurus default My Site page after successful installation.

Web Server Setup

Port

Kinsta automatically sets the PORT environment variable. You do not need to define it or hard-code it into the application. The serve package utilizes the port set by Kinsta automatically.

Start Command

When you deploy the application, Kinsta automatically creates a web process with npm start as the entry point.

Deployment Lifecycle

Whenever a deployment is initiated (through creating an application or re-deploying due to an incoming commit), the npm build command is run, followed by the npm start command.