Cookies concent notice

This site uses cookies from Google to deliver its services and to analyze traffic.
Learn more
Skip to main content
This site is no longer updated.Head to Angular.devHome
/

This is the archived documentation for Angular v17. Please visit angular.dev to see this page for the current version of Angular.

ng serve

Builds and serves your application, rebuilding on file changes.

      
      ng serve [project]
    
      
      ng s [project]
    

Arguments

Argument Description Value Type
project

The name of the project to build. Can be an application or a library.

string

Options

Option Description Value Type Default Value
--allowed-hosts

List of hosts that are allowed to access the dev server. This option has no effect when using the 'application' or other esbuild-based builders.

array
--browser-target

Deprecated: Use 'buildTarget' instead.

A browser builder target to serve in the format of project:target[:configuration]. You can also pass in more than one configuration name as a comma-separated list. Example: project:target:production,staging.

string
--build-target

A build builder target to serve in the format of project:target[:configuration]. You can also pass in more than one configuration name as a comma-separated list. Example: project:target:production,staging.

string
--configuration

One or more named builder configurations as a comma-separated list as specified in the "configurations" section in angular.json. The builder uses the named configurations to run the given target. For more information, see https://angular.io/guide/workspace-config#alternate-build-configurations.

Aliases: -c

string
--disable-host-check

Don't verify connected clients are part of allowed hosts. This option has no effect when using the 'application' or other esbuild-based builders.

boolean false
--force-esbuild

Force the development server to use the 'browser-esbuild' builder when building. This is a developer preview option for the esbuild-based build system.

boolean false
--help

Shows a help message for this command in the console.

boolean
--hmr

Enable hot module replacement.

boolean false
--host

Host to listen on.

string localhost
--live-reload

Whether to reload the page on change, using live-reload.

boolean true
--open

Opens the url in default browser.

Aliases: -o

boolean false
--poll

Enable and define the file watching poll time period in milliseconds.

number
--port

Port to listen on.

number 4200
--prebundle

Enable and control the Vite-based development server's prebundling capabilities. To enable prebundling, the Angular CLI cache must also be enabled. This option has no effect when using the 'browser' or other Webpack-based builders.

boolean
--proxy-config

Proxy configuration file. For more information, see https://angular.io/guide/build#proxying-to-a-backend-server.

string
--public-host

The URL that the browser client (or live-reload client, if enabled) should use to connect to the development server. Use for a complex dev server setup, such as one with reverse proxies. This option has no effect when using the 'application' or other esbuild-based builders.

string
--serve-path

The pathname where the application will be served.

string
--ssl

Serve using HTTPS.

boolean false
--ssl-cert

SSL certificate to use for serving HTTPS.

string
--ssl-key

SSL key to use for serving HTTPS.

string
--verbose

Adds more details to output logging.

boolean
--watch

Rebuild on change.

boolean true