Pular para o conteúdo
Linux para todos os rolês
  1. Rolês e receitas
  2. Receitas
  3. Node.js

Node.js

Instala o Node.js LTS oficial, com o npm instalando pacotes globais na sua pasta pessoal, sem sudo.

dev/node Risco baixo Pede a senha de administrador Testada em máquina virtual no Ubuntu e no Debian
O arquivo do Node.js sai de nodejs.org, passa pela conferência da soma SHA256 gravada na receita e só então é instalado. Os pacotes do npm install -g vão para a pasta pessoal, sem sudo. nodejs.org 26.13.0 LTS SHA256 bate? ✓ instala Se o arquivo não for exatamente o testado, nada é instalado. npm install -g, sem sudo /usr/local/lib/nodejs/ o Node.js, do root ~/.local/lib/node_modules/ os seus pacotes ~/.local/bin/ os seus comandos Nada do root na sua pasta, nada seu na do root.
Ilustração. A versão e as somas ficam gravadas na receita, e sobem junto com o bora.

Em resumo

O que faz e o que não faz

O que faz

  • Instala o Node.js LTS oficial, com o npm e o npx, igual em todas as distros.
  • Confere a soma SHA256 do arquivo baixado antes de instalar.
  • Faz o npm install -g funcionar sem sudo, instalando na sua pasta pessoal.
  • Cria a pasta ~/.local/bin, onde aparecem os comandos instalados pelo npm.

O que não faz

  • Não usa o Node.js da distro, que no Ubuntu 24.04 é a versão 18, já fora de suporte.
  • Não remove o Node.js da distro, se ele estiver instalado: só passa na frente no PATH.
  • Não atualiza sozinho pelo apt: a versão sobe com o bora.
  • Não passa por cima de um node que você instalou à mão em /usr/local/bin.
  • Não apaga os pacotes que você instalou com npm install -g no desfazer.

Passo a passo

Como o bora aplica esta receita

As mesmas quatro etapas de toda receita, com o que esta confere em cada uma.

  1. Verificar já está aplicada?

    Confere se o Node.js da versão da receita está em /usr/local/lib/nodejs, se node, npm e npx em /usr/local/bin apontam para ele, se o npmrc está como a receita escreve e se ~/.local/bin existe.

  2. Aplicar faz a mudança

    • Para, sem mudar nada, se já houver um node em /usr/local/bin que não veio do bora.
    • Baixa o arquivo de nodejs.org, confere a soma SHA256 gravada na receita e abre em /usr/local/lib/nodejs.
    • Cria os links em /usr/local/bin, escreve prefix=${HOME}/.local no npmrc do Node.js e cria ~/.local/bin.
  3. Testar funcionou?

    Como a pessoa: confere a versão do node, o npm e o npx, roda um programa e confere que o npm prefix -g é ~/.local.

  4. Desfazer quando você pedir

    Apaga os links e a pasta do Node.js, remove os pacotes que a receita instalou e a pasta ~/.local/bin, se ainda estiver vazia.

No terminal

Uma aplicação de verdade

A saída de um teste no Ubuntu 26.04, encurtada nas linhas do apt.

Os porquês

Por que assim

Por que não o Node.js da distro?

No Ubuntu 24.04 e nas derivadas, como o Linux Mint 22, o Pop!_OS e o Zorin OS, ele é a versão 18, que saiu de suporte em 2025. As ferramentas de hoje, como o Vite, pedem uma versão mais nova, e o primeiro tutorial já quebraria.

É seguro baixar de fora da distro?

O arquivo vem de nodejs.org, do próprio projeto, e a receita traz a soma SHA256 do arquivo que foi testado. Se o que chegar não bater, nada é instalado. É a regra do projeto para instaladores oficiais.

Por que o npm sem sudo?

Com sudo npm install -g, os arquivos ficam do root, e o próximo npm sem sudo falha com EACCES. Daí para o chmod 777 é um passo, e ninguém quer dar esse passo. Com o prefix em ~/.local, cada pessoa instala na própria pasta.

Como atualizar?

Quando sair um bora com uma versão nova do Node.js, aplique a receita de novo. Ela instala a nova ao lado e troca os links.

Como

O que muda no sistema

Parâmetros

O que dá para escolher

ParâmetroPadrãoO que é
usuarioautoA conta que vai programar, para a pasta ~/.local/bin, onde o npm põe os programas instalados com -g. "auto" é quem rodou o bora com sudo.

No menu, o bora pergunta o que precisa. Num script ou num agente, passe os parâmetros na linha de comando:
bora plano --receitas dev/node -p dev/node.usuario=auto

Confira você mesmo

Os comandos para conferir

node --versionMostra a versão do Node.js.
npm prefix -gMostra onde o npm install -g instala: a sua ~/.local.
npm create vite@latest meu-siteComeça um projeto web com o Vite.

Onde funciona

Distros e testes

UbuntuTestada em VMUbuntu, Mint, Pop!_OS, Zorin
DebianTestada em VMDebian 13
FedoraPlanejadaFedora, Nobara
ArchPlanejadaArch, CachyOS, EndeavourOS, Manjaro
Fedora imutávelPlanejadaBazzite, Silverblue, Kinoite
openSUSEPlanejadaTumbleweed, Leap

Registro de testes

DistroOndeDataResultado
Ubuntu 26.04Contêiner (teste automático)06/11/2026Passou
Ubuntu 24.04Contêiner (teste automático)06/11/2026Passou
Debian 13Contêiner (teste automático)06/11/2026Passou
Debian 13Máquina virtual08/11/2026Passou
Ubuntu 24.04Máquina virtual08/11/2026Passou
Ubuntu 26.04Máquina virtual08/11/2026Passou

Testada em contêiner: passou nos testes automáticos dessa família, que rodam num contêiner a cada pull request, sem kernel, disco nem tela de login de verdade. Testada em VM: além disso, foi aplicada, conferida e desfeita numa máquina virtual (VM) de verdade, o que o CI faz toda semana. O registro acima mostra a última vez de cada distro. Enquanto uma receita só tem o teste em contêiner, o bora avisa quando monta o plano. Testar numa máquina sua é uma das ajudas mais valiosas.

Onde ela entra

Rolês que usam esta receita

Fontes

Para ler mais

Bora melhorar

Falta alguma coisa?

Os pedidos viram issues no GitHub, onde qualquer pessoa pode comentar, votar com um 👍 ou se oferecer para fazer.