Skip to main content

Advanced Installation

If there are any issues with the quick script installation, if you want a better understanding of how the Netuno installation works, or for any other reason, a manual installation can be done.

Choose your desired version. The selection made here will apply to all command blocks on this page.

The Stable Version is the approved edition of Netuno. It has undergone rigorous testing and is fully ready for use in production environments.

Prerequisites​

Before you begin, check what you need to have installed on your computer:

  • Java (Installer only)

    Java must be previously installed on your operating system. It will be used exclusively to run the initial Netuno installation script.

  • GraalVM (Automatic Installation)

    During installation, the GraalVM engine is downloaded and configured automatically within the Netuno folder itself. From this point on, the isolated GraalVM Java will be used to run the platform, ensuring stability and high performance without interfering with your machine's global settings.

To learn more about the technology, visit: GraalVM.

FRONTEND REQUIREMENTS ARE OPTIONAL

Installing frontend tools (such as Node.js, NPM, or Yarn) is entirely optional. You will only need to configure them if your goal is to develop advanced full-stack interfaces.

Backend - Java​

This step ensures the environment is prepared to run the platform installer. Java version 11 or higher must be installed.

Check if Java is already installed by running the following command in your terminal:

java -version

If it is not installed, we recommend installing the open-source Java:

apt install default-jdk-headless

Frontend - Bun​

To develop user interfaces (UI / Frontend), we recommend using Bun — the official standard tool in the Netuno ecosystem for frontend compilation.

Why use Bun?​

Bun is a modern and highly optimized alternative to Node.js. It stands out in the Netuno environment by offering:

  • High Performance: Noticeably faster execution and dependency installation.
  • Productivity: Better performance in the daily workflow of interface development.
  • Native Integration: All Netuno example projects and templates come pre-configured to work with Bun.

See the guide at: Bun Installation.

Netuno doesn't restrict your technological choices. If you prefer, you can use Node.js with NPM, PNPM, Yarn, or any other package manager. The choice of frontend stack is entirely up to you.

KEEP YOUR TOOLS UPDATED

Regardless of the technology chosen, always use the latest versions to ensure compatibility, security, and performance.

Linux or macOS​

Most Linux distributions and macOS already include cURL or Wget by default. Check which one is available:

curl --version
wget --version

Follow the steps below:

1. Create the folder and access it:

mkdir -p netuno && cd netuno

2. Download the installer (choose only one method):

With cURL:

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

With Wget:

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

3. Run the installation:

java -jar netuno-setup.jar install
ATTENTION

macOS has a native security mechanism (Gatekeeper) that can block applications downloaded via the terminal.

On macOS, to ensure that Netuno works without permission errors, run the command below immediately after step 3, still inside the netuno folder:

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

The system will ask for your Mac's administrator password to confirm.

Windows​

We will use PowerShell to download and install. Open PowerShell from the Start menu by typing powershell.

1. Create the folder, access it, and download the installer. Copy the entire block and press 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. Run the installation:

java -jar netuno-setup.jar install
ATTENTION

The standard installation usually does not require elevated privileges. However, if you receive an "Access Denied" message, close PowerShell, reopen it as Administrator, and run the command again.

Restarting from Scratch​

To clear the environment and start over from scratch:

1. Go back one level in the terminal:

cd ..

2. Remove the failed folder:

rm -rf netuno

3. Restart the installation.