Skip to main content

Deploy Manifest on Fly.io

Fly.io is a cloud provider that focuses on user experience and zero-config deployments.

Create a "start" script for production​

The npm run manifest script should only be used for development as it watches file changes.

Go back to your codebase and open the package.json file and add a new start script on the scripts list with the value node node_modules/manifest/dist/manifest/src/main.js as following:

package.json
"scripts": {
    "start": "node node_modules/manifest/dist/manifest/src/main.js"
    [...]
}

Create a new app

First create a Fly.io account or sign in to access your dashboard. Click on "Launch an app" to start the process.

In our example we are deploying a Manifest backend hosted in GitHub. You can also connect to your codebase using the Fly.io CLI.After configuring your GitHub integration with Fly.io, select the repository and click on "Deploy repository" to launch the deployment.

Fly.io new app

Configure your app​

The next screen will allow you to configure the app to make it work as you want. Here are the settings that you can or must update (in UI order):

  • Basics (optional): Choose your app's name
  • Region (optional): Choose the region closest to where your audience is
  • Network: Set the internal port to 1111 to match the default Manifest port.
  • CPU & Memory (optional): Manifest can run on the 1 CPU and 512 MB VM Memory on small/medium projects. The default size is a bit bigger, you can replace it by a smaller one if you want.
  • Secrets: Add the 2 secrets: TOKEN_SECRET_KEY (which you can generate at JWTSecret.com) and NODE_ENV=production.

Validate the config and Fly.io will build the image and deploy.

🎉 That's it! Click on "View app" to see it.