https://github.com/angular/angular
Raw File
Tip revision: 054de6dc34504c782944cb04e7687aaae2323a34 authored by Andrew Scott on 06 July 2022, 16:28:37 UTC
release: cut the v14.0.5 release (#46724)
Tip revision: 054de6d
start-deployment.md
# Deploying an application

Deploying your application is the process of compiling, or building, your code and hosting the JavaScript, CSS, and HTML on a web server.

This section builds on the previous steps in the [Getting Started](start "Try it: A basic application") tutorial and shows you how to deploy your application.

## Prerequisites

A best practice is to run your project locally before you deploy it. To run your project locally, you need the following installed on your computer:

*   [Node.js](https://nodejs.org/en).
*   The [Angular CLI](https://cli.angular.io).
    From the terminal, install the Angular CLI globally with:

    <code-example format="shell" language="shell">

    npm install -g &commat;angular/cli

    </code-example>

    With the Angular CLI, you can use the command `ng` to create new workspaces, new projects, serve your application during development, or produce builds to share or distribute.

## Running your application locally

1.  Download the source code from your StackBlitz project by clicking the `Download Project` icon in the left menu, across from `Project`, to download your project as a zip archive.

    <div class="lightbox">

    <img alt="Download the stackblitz project" src="generated/images/guide/start/download-project.png">

    </div>

1.  Unzip the archive and change directory to the newly created project. For example:

    <code-example format="shell" language="shell">

    cd angular-ynqttp

    </code-example>

1.  To download and install npm packages, use the following npm CLI command:

    <code-example format="shell" language="shell">

    npm install

    </code-example>

1.  Use the following CLI command to run your application locally:

    <code-example format="shell" language="shell">

    ng serve

    </code-example>

1.  To see your application in the browser, go to http://localhost:4200/.
    If the default port 4200 is not available, you can specify another port with the port flag as in the following example:

     <code-example format="shell" language="shell">

    ng serve --port 4201

    </code-example>

    While serving your application, you can edit your code and see the changes update automatically in the browser.
    To stop the `ng serve` command, press `Ctrl`+`c`.

<a id="building"></a>

## Building and hosting your application

1.  To build your application for production, use the `build` command. By default, this command uses the `production` build configuration.

    <code-example format="shell" language="shell">

    ng build

    </code-example>

    This command creates a `dist` folder in the application root directory with all the files that a hosting service needs for serving your application.

    <div class="alert is-helpful">

    If the above `ng build` command throws an error about missing packages, append the missing dependencies in your local project's `package.json` file to match the one in the downloaded StackBlitz project.

    </div>

1.  Copy the contents of the `dist/my-project-name` folder to your web server.
    Because these files are static, you can host them on any web server capable of serving files; such as `Node.js`, Java, .NET, or any backend such as [Firebase](https://firebase.google.com/docs/hosting), [Google Cloud](https://cloud.google.com/solutions/web-hosting), or [App Engine](https://cloud.google.com/appengine/docs/standard/python/getting-started/hosting-a-static-website).
    For more information, see [Building & Serving](guide/build "Building and Serving Angular Apps") and [Deployment](guide/deployment "Deployment guide").

## What's next

In this tutorial, you've laid the foundation to explore the Angular world in areas such as mobile development, UX/UI development, and server-side rendering.
You can go deeper by studying more of Angular's features, engaging with the vibrant community, and exploring the robust ecosystem.

### Learning more Angular

For a more in-depth tutorial that leads you through building an application locally and exploring many of Angular's most popular features, see [Tour of Heroes](tutorial).

To explore Angular's foundational concepts, see the guides in the Understanding Angular section such as [Angular Components Overview](guide/component-overview) or [Template syntax](guide/template-syntax).

### Joining the community

[Tweet that you've completed this tutorial](https://twitter.com/intent/tweet?url=https://angular.io/start&text=I%20just%20finished%20the%20Angular%20Getting%20Started%20Tutorial "Angular on Twitter"), tell us what you think, or submit [suggestions for future editions](https://github.com/angular/angular/issues/new/choose "Angular GitHub repository new issue form").

Keep current by following the [Angular blog](https://blog.angular.io/ "Angular blog").

### Exploring the Angular ecosystem

To support your UX/UI development, see [Angular Material](https://material.angular.io/ "Angular Material web site").

The Angular community also has an extensive [network of third-party tools and libraries](resources "Angular resources list").

@reviewed 2021-09-15
back to top