GV

GeezerVison

The World Wide Web, restored to 800 pixels of glory.

Home|About|Gaming cabinet|Archives|How it works|Starter sites

On this site

  • Sign in
  • ActionsCI/CD and automation
  • CodespacesCloud development environments
  • All Features
  • Documentation
  • Training
  • Certifications
  • Build with Copilot
  • Customize Copilot
  • Integrations
  • Trending repos
  • GitHub Sponsors
  • Developer articles
  • Enterprises

This view

  • Original page
  • New address

GeezerVison is showing github.com — The upgrade guide does not cover `ng update` stopping on a Node.js version message · Issue #3786 · angular/angularfire

The upgrade guide does not cover ng update stopping on a Node.js version message #3786

New issue
Copy link
New issue
Copy link
Closed
#3788
Closed
The upgrade guide does not cover ng update stopping on a Node.js version message#3786
#3788
Copy link
Labels
comp: docsDocumentation.Documentation.type: choreMaintenance with no user-facing behavior change.Maintenance with no user-facing behavior change.version: current (v17+)Targets the current modular API (v17+).Targets the current modular API (v17+).
Milestone
21.0.0-rc.2

Description

@armando-navarro
armando-navarro
opened on Oct 2, 2026
Issue body actions

In an app that is already on Angular 21, ng update @angular/fire@next can stop before it updates anything:

Installing a temporary Angular CLI versioned latest to perform the update.
Node.js version v22.22.1 detected.
The Angular CLI requires a minimum Node.js version of v22.22.3 or v24.15.0 or v26.0.0.

Node.js 22.22.1 is a version Angular 21 supports, so the message is confusing, and docs/version-21-upgrade.md does not mention it.

Why it happens

  • ng update chooses which Angular CLI runs the update from the first @angular/ package in the command. If that package has no version number, it downloads @angular/cli@latest.
  • @angular/cli@latest is 22.2.1, which requires Node.js ^22.22.3 || ^24.15.0 || >=26.0.0. Angular CLI 21 accepts ^20.19.0 || ^22.12.0 || >=24.0.0.
  • On a Node.js version in between, the downloaded CLI refuses to start. This is Angular CLI behavior, and it happens before any AngularFire code runs.

What I ran

On Node.js 22.22.1, on 2026-10-02:

  • ng update @angular/fire and ng update @angular/fire@next in an Angular 21 app both stop with the message above.
  • ng update @angular/[email protected] in the same app does not.
  • The guide's own command, ng update @angular/core@21 @angular/cli@21 @angular/fire@next, is not affected. It ran with a temporary Angular CLI 21.2.24 and completed.

Proposed change

A bullet under "Other notes" naming the message, the cause, and the two ways past it: update Node.js, or give the first @angular/ package a version number.

Activity

  1. armando-navarro
    added
    comp: docsDocumentation.Documentation.
    type: choreMaintenance with no user-facing behavior change.Maintenance with no user-facing behavior change.
    version: current (v17+)Targets the current modular API (v17+).Targets the current modular API (v17+).
    on Oct 2, 2026
  2. armando-navarro
    closed this as completedin #3788on Oct 5, 2026
  3. armando-navarro
    added this to the 21.0.0-rc.2 milestone on Oct 5, 2026
  4. armando-navarro
    added a commit that references this issue on Oct 5, 2026

    docs: cover ng update stopping on a Node.js version message (angular#…

    This issue will close once commit 110dac1 is merged into the 'main' branch.
    110dac1
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    comp: docsDocumentation.Documentation.type: choreMaintenance with no user-facing behavior change.Maintenance with no user-facing behavior change.version: current (v17+)Targets the current modular API (v17+).Targets the current modular API (v17+).

    Type

    No type

    Projects

    No projects

      Milestone

      • 21.0.0-rc.2

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions

      You are visitor 01402520 — GeezerVison does not store the pages you look up.
      Best viewed with Netscape Navigator 4.7 or Internet Explorer 6 at 800×600. No cookies required.