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 cache

Configure persistent disk cache and retrieve cache statistics.

      
      ng cache
    

Description

Angular CLI saves a number of cachable operations on disk by default.

When you re-run the same build, the build system restores the state of the previous build and re-uses previously performed operations, which decreases the time taken to build and test your applications and libraries.

To amend the default cache settings, add the cli.cache object to your Workspace Configuration. The object goes under cli.cache at the top level of the file, outside the projects sections.

      
      {
  "$schema": "./node_modules/@angular/cli/lib/config/schema.json",
  "version": 1,
  "cli": {
    "cache": {
      // ...
    }
  },
  "projects": {}
}
    

For more information, see cache options.

Cache environments

By default, disk cache is only enabled for local environments. The value of environment can be one of the following:

  • all - allows disk cache on all machines.
  • local - allows disk cache only on development machines.
  • ci - allows disk cache only on continuous integration (CI) systems.

To change the environment setting to all, run the following command:

      
      ng config cli.cache.environment all
    

For more information, see environment in cache options.

The Angular CLI checks for the presence and value of the CI environment variable to determine in which environment it is running.

Cache path

By default, .angular/cache is used as a base directory to store cache results.

To change this path to .cache/ng, run the following command:

      
      ng config cli.cache.path ".cache/ng"
    

This command has the following sub-commands:

Options

Option Description Value Type Default Value
--help

Shows a help message for this command in the console.

boolean

Cache commands

clean

      
      ng cache clean
    

Deletes persistent disk cache from disk.

disable

      
      ng cache disable
    
      
      ng cache off
    

Disables persistent disk cache for all projects in the workspace.

enable

      
      ng cache enable
    
      
      ng cache on
    

Enables disk cache for all projects in the workspace.

info

      
      ng cache info
    

Prints persistent disk cache configuration and statistics in the console.