Pular para o conteúdo principal

Instalação Avançada

Caso haja algum problema com a instalação rápida via script, ou se queira ter um entendimento melhor de como a instalação do Netuno funciona, ou por qualquer outro motivo, pode-se fazer a instalação manual.

Escolha a versão desejada. A seleção feita aqui se aplicará a todos os blocos de comando desta página.

A Versão Estável é a edição homologada do Netuno. Ela passou por testes rigorosos e está totalmente pronta para uso em ambientes de produção.

Pré-requisitos​

Antes de começar, verifique o que precisa ter instalado no seu computador:

  • Java (Apenas para o instalador)

É necessário ter o Java previamente instalado no seu sistema operacional. Ele será usado exclusivamente para rodar o script inicial de instalação do Netuno.

  • GraalVM (Instalação Automática)

Durante a instalação, o motor GraalVM é baixado e configurado automaticamente dentro da própria pasta do Netuno. A partir desse ponto, o Java do GraalVM isolado será utilizado para rodar a plataforma, garantindo estabilidade e alta performance sem interferir nas configurações globais da sua máquina.

Para saber mais sobre a tecnologia, acesse: GraalVM.

Requisitos de Frontend são Opcionais

A instalação de ferramentas de frontend (como Node.js, NPM ou Yarn) é totalmente opcional. Você só precisará configurá-las se o seu objetivo for desenvolver interfaces avançadas em modo full-stack.

Backend - Java​

Esta etapa garante que o ambiente esteja preparado para executar o instalador da plataforma. É necessário ter o Java versão 11 ou superior instalado.

Verifique se o Java já está instalado executando o comando abaixo no terminal:

java -version

Caso não esteja instalado, recomendamos a instalação do Java open source:

apt install default-jdk-headless

Frontend - Bun​

Para desenvolver interfaces de usuário (UI / Frontend), recomendamos o uso do Bun, a ferramenta padrão oficial do ecossistema Netuno para compilação de frontend.

Por que usar o Bun?​

O Bun é uma alternativa moderna e altamente otimizada ao Node.js. Ele se destaca no ambiente Netuno por oferecer:

  • Alta Performance: Execução e instalação de dependências visivelmente mais rápidas.
  • Produtividade: Melhor desempenho no fluxo diário de desenvolvimento de interfaces.
  • Integração Nativa: Todos os projetos de exemplo e templates do Netuno já vêm pré-configurados para funcionar com Bun.

Acesse o guia em: Instalação do Bun

O Netuno não engessa suas escolhas tecnológicas. Caso prefira, é possível utilizar Node.js com NPM, PNPM, Yarn ou qualquer outro gerenciador de pacotes. A escolha da stack de frontend fica inteiramente a seu critério.

MANTENHA AS FERRAMENTAS ATUALIZADAS

Independentemente da tecnologia escolhida, utilize sempre as versões mais recentes para garantir compatibilidade, segurança e performance.

Linux ou macOS​

A maioria das distribuições Linux e o macOS já incluem o cURL ou o Wget por padrão. Verifique qual está disponível:

curl --version
wget --version

Siga as etapas abaixo:

1. Crie a pasta e acesse-a:

mkdir -p netuno && cd netuno

2. Baixe o instalador (escolha apenas um método):

Com cURL:

curl -L https://github.com/netuno-org/platform/releases/download/stable/netuno-setup.jar -o netuno-setup.jar

Com Wget:

wget https://github.com/netuno-org/platform/releases/download/stable/netuno-setup.jar -O netuno-setup.jar

3. Execute a instalação:

java -jar netuno-setup.jar install
ATENÇÃO

O macOS possui um mecanismo de segurança nativo (Gatekeeper) que pode bloquear aplicativos baixados via terminal.

No macOS para garantir que o Netuno funcione sem erros de permissão, execute o comando abaixo imediatamente após o passo 3, ainda dentro da pasta netuno.

sudo xattr -r -d com.apple.quarantine .

O sistema solicitará a senha de administrador do seu Mac para confirmar.

Windows​

Utilizaremos o PowerShell para realizar o download e a instalação. Abra o PowerShell pelo menu Iniciar digitando powershell.

1. Crie a pasta, acesse-a e baixe o instalador. Copie o bloco completo e pressione Enter:

md netuno; cd netuno
Invoke-WebRequest -Uri "https://github.com/netuno-org/platform/releases/download/stable/netuno-setup.jar" -OutFile "netuno-setup.jar"

2. Execute a instalação:

java -jar netuno-setup.jar install
ATENÇÃO

A instalação padrão geralmente não exige privilégios elevados. Porém, se receber uma mensagem de "Acesso Negado", feche o PowerShell, reabra-o como Administrador e execute o comando novamente.

Recomeçando do Zero​

Para limpar o ambiente e recomeçar do zero:

1. Volte um nível no terminal:

cd ..

2. Remova a pasta com falha:

rm -rf netuno

3. Reinicie a instalação.