Przejdź do głównej treści

Zaawansowana instalacja

Jeśli wystąpią jakiekolwiek problemy z szybką instalacją za pomocą skryptu, chcesz lepiej zrozumieć, jak działa instalacja Netuno, lub masz inny powód, możesz wykonać instalację ręczną.

Wybierz żądaną wersję. Wybór dokonany tutaj będzie miał zastosowanie do wszystkich bloków poleceń na tej stronie.

Wersja stabilna to zatwierdzona edycja Netuno. Przeszła rygorystyczne testy i jest w pełni gotowa do użycia w środowiskach produkcyjnych.

Wymagania wstępne​

Zanim zaczniesz, sprawdź, co musisz mieć zainstalowane na komputerze:

  • Java (Tylko dla instalatora)

Konieczne jest wcześniejsze zainstalowanie środowiska Java w systemie operacyjnym. Będzie ono używane wyłącznie do uruchomienia początkowego skryptu instalacyjnego Netuno.

  • GraalVM (Automatyczna instalacja)

Podczas instalacji silnik GraalVM jest pobierany i automatycznie konfigurowany wewnątrz folderu Netuno. Od tego momentu izolowana Java z GraalVM będzie używana do uruchamiania platformy, zapewniając stabilność i wysoką wydajność bez wpływu na globalne konfiguracje Twojej maszyny.

Aby dowiedzieć się więcej o tej technologii, odwiedź: GraalVM.

Wymagania frontendu są opcjonalne

Instalacja narzędzi frontendowych (takich jak Node.js, NPM lub Yarn) jest całkowicie opcjonalna. Będziesz musiał je skonfigurować tylko wtedy, gdy Twoim celem jest tworzenie zaawansowanych interfejsów w trybie full-stack.

Backend - Java​

Ten etap zapewnia, że środowisko jest przygotowane do uruchomienia instalatora platformy. Konieczne jest zainstalowanie Java w wersji 11 lub nowszej.

Sprawdź, czy Java jest już zainstalowana, wykonując poniższe polecenie w terminalu:

java -version

Jeśli nie jest zainstalowana, zalecamy instalację Java open source:

apt install default-jdk-headless

Frontend - Bun​

Do tworzenia interfejsów użytkownika (UI / Frontend) zalecamy używanie Bun, oficjalnego standardowego narzędzia ekosystemu Netuno do kompilacji frontendu.

Dlaczego warto używać Bun?​

Bun to nowoczesna i wysoce zoptymalizowana alternatywa dla Node.js. W środowisku Netuno wyróżnia się tym, że oferuje:

  • Wysoka wydajność: Zauważalnie szybsze uruchamianie i instalacja zależności.
  • Produktywność: Lepsza wydajność w codziennym procesie tworzenia interfejsów.
  • Natywna integracja: Wszystkie projekty przykładowe i szablony Netuno są już wstępnie skonfigurowane do pracy z Bun.

Zapoznaj się z przewodnikiem: Instalacja Bun

Netuno nie narzuca wyborów technologicznych. Jeśli wolisz, możesz używać Node.js z NPM, PNPM, Yarn lub dowolnym innym menedżerem pakietów. Wybór stosu frontendowego pozostaje całkowicie w Twojej gestii.

UTRZYMUJ NARZĘDZIA W AKTUALNEJ WERSJI

Niezależnie od wybranej technologii zawsze używaj najnowszych wersji, aby zapewnić zgodność, bezpieczeństwo i wydajność.

Linux lub macOS​

Większość dystrybucji Linux oraz macOS domyślnie zawiera cURL lub Wget. Sprawdź, które z nich jest dostępne:

curl --version
wget --version

Wykonaj poniższe kroki:

1. Utwórz folder i przejdź do niego:

mkdir -p netuno && cd netuno

2. Pobierz instalator (wybierz tylko jedną metodę):

Za pomocą cURL:

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

Za pomocą Wget:

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

3. Uruchom instalację:

java -jar netuno-setup.jar install
UWAGA

macOS ma wbudowany mechanizm bezpieczeństwa (Gatekeeper), który może blokować aplikacje pobrane przez terminal.

W systemie macOS, aby zapewnić działanie Netuno bez błędów uprawnień, wykonaj poniższe polecenie natychmiast po kroku 3, nadal będąc w folderze netuno.

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

System poprosi o potwierdzenie hasłem administratora Twojego Maca.

Windows​

Użyjemy PowerShell, aby pobrać i zainstalować. Otwórz PowerShell z menu Start, wpisując powershell.

1. Utwórz folder, przejdź do niego i pobierz instalator. Skopiuj cały blok i naciśnij 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. Uruchom instalację:

java -jar netuno-setup.jar install
UWAGA

Standardowa instalacja zazwyczaj nie wymaga podwyższonych uprawnień. Jeśli jednak otrzymasz komunikat „Odmowa dostępu”, zamknij PowerShell, otwórz go ponownie jako Administrator i wykonaj polecenie jeszcze raz.

Rozpoczęcie od zera​

Aby wyczyścić środowisko i zacząć od zera:

1. Wróć o jeden poziom w terminalu:

cd ..

2. Usuń folder po nieudanej instalacji:

rm -rf netuno

3. Uruchom instalację ponownie.