angular / 11.2.14 / cli / serve.html /

ng serve

Builds and serves your app, rebuilding on file changes.

ng serve <project> [options]

ng s <project> [options]

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.

array
--aot

Deprecated: Use the "aot" option in the browser builder instead.

Build using Ahead of Time compilation.

boolean
--base-href

Deprecated: Use the "baseHref" option in the browser builder instead.

Base url for the application being built.

string
--browser-target

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
--common-chunk

Deprecated: Use the "commonChunk" option in the browser builder instead.

Generate a seperate bundle containing code used across multiple bundles.

boolean
--configuration

One or more named builder configurations as a comma-separated list as specified in the "configurations" section of 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. Setting this explicitly overrides the "--prod" flag.

Aliases: -c

string
--deploy-url

Deprecated: Use the "deployUrl" option in the browser builder instead.

URL where files will be deployed.

string
--disable-host-check

Don't verify connected clients are part of allowed hosts.

boolean false
--help

Shows a help message for this command in the console.

true|false|json|JSON false
--hmr

Enable hot module replacement.

boolean false
--hmr-warning

Deprecated: No longer has an effect.

Show a warning when the --hmr option is enabled.

boolean true
--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
--optimization

Deprecated: Use the "optimization" option in the browser builder instead.

Enables optimization of the build output. Including minification of scripts and styles, tree-shaking, dead-code elimination, tree-shaking and fonts inlining. For more information, see https://angular.io/guide/workspace-config#optimization-configuration.

boolean
--poll

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

number
--port

Port to listen on.

number 4200
--prod

Shorthand for "--configuration=production". Set the build configuration to the production target. By default, the production target is set up in the workspace configuration such that all builds make use of bundling, limited tree-shaking, and also limited dead code elimination.

boolean
--progress

Deprecated: Use the "progress" option in the browser builder instead.

Log progress to the console while building.

boolean
--proxy-config

Proxy configuration file.

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.

string
--serve-path

The pathname where the app will be served.

string
--serve-path-default-warning

Deprecated: No longer has an effect.

Show a warning when deploy-url/base-href use unsupported serve path values.

boolean true
--source-map

Deprecated: Use the "sourceMap" option in the browser builder instead.

Output source maps for scripts and styles. For more information, see https://angular.io/guide/workspace-config#source-map-configuration.

boolean
--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
--vendor-chunk

Deprecated: Use the "vendorChunk" option in the browser builder instead.

Generate a seperate bundle containing only vendor libraries. This option should only used for development.

boolean
--verbose

Adds more details to output logging.

boolean
--watch

Rebuild on change.

boolean true

© 2010–2021 Google, Inc.
Licensed under the Creative Commons Attribution License 4.0.
https://v11.angular.io/cli/serve