Next.js - CLI start Command



In Next.js CLI, the `start` command is used to start a production server for a Next.js application. This command is typically used after building the application with the `build` command. In this chapter, we will explain how to use the `start` command and its available options to customize the server's behavior.

Next.js Start Command Syntax

Following is the syntax of the start command in Next.js CLI.

npx next start [options]

For example, npx next start -p 5000, specifies the port number as 5000 for starting the server.

Options of Start Command

Below is a list of options available for the `start` command.

Options Explanation
-h or --help Show all available options.
[directory] Specifies the directory to start the application. If no directory is provided, the current directory is used.
-p or --port Specifies a port number on which to start the application. Default is 3000.
-H or --hostname Specifies a hostname on which to start the application. Default is 0.0.0.0.
--keepAliveTimeout Specifies the maximum number of milliseconds to wait before closing inactive connections.

Start Server on a Custom Port

In Next.js, we can use the start command to run the production server on a custom port.

npx next start -p 3039

After running the above command in your terminal, the Next.js production server will start running on `http://localhost:3039/`.

Output

next.js-start-command

Start Server on a Custom Hostname

In Next.js, we can use the start command to specify a custom hostname for the production server.

npx next start -H 127.0.34.1

After running the above command in your terminal, the Next.js production server will start running on `http://127.0.34.1:3000/`.

Output

In the output, you can see that the Next.js server is running on the specified port and hostname as per the examples above.

next.js-start-host
Advertisements