Tutorial

How To Restart Your Node.js Apps Automatically with nodemon

Updated on November 24, 2021
Default avatar

By Alligator.io

English
How To Restart Your Node.js Apps Automatically with nodemon

Introduction

In Node.js, you need to restart the process to make changes take effect. This adds an extra step to your workflow. You can eliminate this extra step by using nodemon to restart the process automatically.

nodemon is a command-line interface (CLI) utility developed by @rem that wraps your Node app, watches the file system, and automatically restarts the process.

In this article, you will learn about installing, setting up, and configuring nodemon.

Deploy your frontend applications from GitHub using DigitalOcean App Platform. Let DigitalOcean focus on scaling your app.

Prerequisites

If you would like to follow along with this article, you will need:

This tutorial was verified with Node.js v17.1.0, npm v8.1.2, nodemon v2.0.15, and express v4.17.1.

Step 1 — Installing nodemon

First, you will need to install nodemon on your machine. Install the utility either globally or locally on your project using npm or yarn:

Global Installation

You can install nodemon globally with npm:

  1. npm install nodemon --global

Or with yarn:

  1. yarn global add nodemon

Local Installation

You can also install nodemon locally. When performing a local installation, you can install nodemon as a dev dependency with --save-dev (or --dev).

Install nodemon locally with npm:

  1. npm install nodemon --save-dev

Or with yarn:

  1. yarn add nodemon --dev

One thing to be aware of with a local install is that you will not be able to use the nodemon command directly:

  1. Output
    command not found: nodemon

You can execute the locally installed package:

  1. ./node_modules/nodemon/bin/nodemon.js [your node app]

You can also use it in npm scripts or with npx.

This concludes the nodemon installation process.

Step 2 — Setting Up an Example Express Project with nodemon

You can use nodemon to start a Node script. For example, if you have an Express server setup in a server.js file, you can start nodemon and watch for changes like this:

  1. nodemon server.js

You can pass in arguments the same way as if you were running the script with Node:

  1. nodemon server.js 3006

Every time you make a change to a file with one of the default watched extensions (.js, .mjs, .json, .coffee, or .litcoffee) in the current directory or a subdirectory, the process will restart.

Let’s write an example server.js file that outputs the message: Dolphin app listening on port ${port}!.

server.js
const express = require('express')
const app = express()
const port = 3000

app.listen(port, ()=> console.log(`Dolphin app listening on port ${port}!`))

Run the example with nodemon:

  1. nodemon server.js

The terminal output will display:

Output
[nodemon] 2.0.15 [nodemon] to restart at any time, enter `rs` [nodemon] watching path(s): *.* [nodemon] watching extensions: js,mjs,json [nodemon] starting `node server.js` Dolphin app listening on port 3000!

While nodemon is still running, let’s make a change to the server.js file. Change the output a different message: Shark app listening on port ${port}!.

The terminal output will display:

Output
[nodemon] restarting due to changes... [nodemon] starting `node server.js` Shark app listening on port 3000!

The terminal output from the Node.js app is displaying the new changes.

You can restart the process at any time by typing rs and hitting ENTER.

Alternatively, nodemon will also look for a main file specified in your project’s package.json file:

package.json
{
  // ...
  "main": "server.js",
  // ...
}

If a main file is not specified, nodemon will search for a start script:

package.json
{
  // ...
  "scripts": {
    "start": "node server.js"
  },
  // ...
}

Once you make the changes to package.json, you can then call nodemon to start the example app in watch mode without having to pass in server.js.

Step 3 — Using Options

You can modify the configuration settings available to nodemon.

Let’s go over some of the main options:

  • --exec: Use the --exec switch to specify a binary to execute the file with. For example, when combined with the ts-node binary, --exec can become useful to watch for changes and run TypeScript files.
  • --ext: Specify different file extensions to watch. For this switch, provide a comma-separated list of file extensions (e.g., --ext js,ts).
  • --delay: By default, nodemon waits for one second to restart the process when a file changes, but with the --delay switch, you can specify a different delay. For example, nodemon --delay 3.2 for a 3.2-second delay.
  • --watch: Use the --watch switch to specify multiple directories or files to watch. Add one --watch switch for each directory you want to watch. By default, the current directory and its subdirectories are watched, so with --watch you can narrow that to only specific subdirectories or files.
  • --ignore: Use the --ignore switch to ignore certain files, file patterns, or directories.
  • --verbose: A more verbose output with information about what file(s) changed to trigger a restart.

You can view all the available options with the following command:

  1. nodemon --help

Using these options, let’s create the command to satisfy the following scenario:

  • watching the server directory
  • specifying files with a .ts extension
  • ignoring files with a .test.ts suffix
  • executing the file (server/server.ts) with ts-node
  • waiting for three seconds to restart after a file changes
  1. nodemon --watch server --ext ts --exec ts-node --ignore '*.test.ts' --delay 3 server/server.ts

The terminal output will display:

Output
[nodemon] 2.0.15 [nodemon] to restart at any time, enter `rs` [nodemon] watching path(s): server [nodemon] watching extensions: ts [nodemon] starting `ts-node server/server.ts`

This command combines --watch, --ext, --exec, --ignore, and --delay options to satisfy the conditions for our scenario.

Step 4 — Using Configurations

In the previous example, adding configuration switches when running nodemon can get tedious. A better solution for projects that require complicated configurations is to define these options in a nodemon.json file.

For example, here are the same configurations as the previous command line example, but placed in a nodemon.json file:

nodemon.json
{
  "watch": [
    "server"
  ],
  "ext": "ts",
  "ignore": [
    "*.test.ts"
  ],
  "delay": "3",
  "execMap": {
    "ts": "ts-node"
  }
}

Note the use of execMap instead of the --exec switch. execMap allows you to specify binaries for certain file extensions.

Alternatively, if you would rather not add a nodemon.json config file to your project, you can add these configurations to the package.json file under a nodemonConfig key:

package.json
{
  "name": "nodemon-example",
  "version": "1.0.0",
  "description": "",
  "nodemonConfig": {
    "watch": [
      "server"
    ],
    "ext": "ts",
    "ignore": [
      "*.test.ts"
    ],
    "delay": "3",
    "execMap": {
      "ts": "ts-node"
    }
  },
  // ...

Once you make the changes to either nodemon.json or package.json, you can then start nodemon with the desired script:

  1. nodemon server/server.ts

nodemon will pick up the configurations and use them. This way, your configurations can be saved, shared, and repeated to avoid copy-and-pasting or typing errors in the command line.

Conclusion

In this article, you explored how to use nodemon with your Node.js applications. This tool helps automate the process of stopping and starting a Node server to view the changes.

For more information about the available features and troubleshooting errors, consult the official documentation.

If you’d like to learn more about Node.js, check out our Node.js topic page for exercises and programming projects.

Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.

Learn more about us


About the authors
Default avatar
Alligator.io

author



Still looking for an answer?

Ask a questionSearch for more help

Was this helpful?
 
2 Comments


This textbox defaults to using Markdown to format your answer.

You can type !ref in this text area to quickly search our full set of tutorials, documentation & marketplace offerings and insert the link!

praise to nodemon but maybe try alternativ https://github.com/jbystronski/watcher

nodemonConfig key in package.json and nodemon.json both take parameters for “delay” key in milliseconds rather than seconds.

Try DigitalOcean for free

Click below to sign up and get $200 of credit to try our products over 60 days!

Sign up

Join the Tech Talk
Success! Thank you! Please check your email for further details.

Please complete your information!

Get our biweekly newsletter

Sign up for Infrastructure as a Newsletter.

Hollie's Hub for Good

Working on improving health and education, reducing inequality, and spurring economic growth? We'd like to help.

Become a contributor

Get paid to write technical tutorials and select a tech-focused charity to receive a matching donation.

Welcome to the developer cloud

DigitalOcean makes it simple to launch in the cloud and scale up as you grow — whether you're running one virtual machine or ten thousand.

Learn more
DigitalOcean Cloud Control Panel