Przed konfiguracją środowiska Node.js w Plesk musisz najpierw wgrać pliki swojej aplikacji na serwer. Możesz to zrobić przez wbudowany Menedżer plików Plesk lub przez FTP.

1. Zaloguj się do panelu Plesk i przejdź do Witryny i domeny.
2. Kliknij Menedżer plików dla wybranej domeny.
3. Utwórz katalog dla swojej aplikacji lub użyj katalogu httpdocs.
4. Wgraj wszystkie pliki aplikacji: app.js (lub server.js), package.json, package-lock.json i inne pliki projektu.
5. Uwaga: nie musisz wgrywać katalogu node_modules — Plesk zainstaluje zależności automatycznie po kliknięciu NPM Install.

Konfiguracja Node.js w Plesk jest dostępna bezpośrednio z panelu zarządzania domeną. Oferuje intuicyjny interfejs do wszystkich ustawień środowiska uruchomieniowego aplikacji.

1. Zaloguj się do panelu Plesk.
2. Kliknij Witryny i domeny w lewym menu.
3. Na liście domen kliknij nazwę domeny, pod którą ma działać Twoja aplikacja Node.js.
4. W panelu domeny odszukaj ikonę lub kafelek Node.js i kliknij go.

Plesk obsługuje wiele wersji Node.js jednocześnie, co pozwala na dostosowanie środowiska uruchomieniowego do wymagań konkretnej aplikacji. Wybór właściwej wersji jest kluczowy dla poprawnego działania aplikacji.

1. Na ekranie konfiguracji Node.js znajdź sekcję Node.js Version (Wersja Node.js).
2. Kliknij aktualną wersję (lub numer w polu wyboru), aby rozwinąć listę dostępnych wersji.
3. Wybierz wersję wymaganą przez Twoją aplikację. Jeśli nie masz specjalnych wymagań, wybierz najnowszą wersję LTS (Long Term Support).
4. Wersja LTS jest oznaczona jako stabilna i otrzymuje długoterminowe wsparcie bezpieczeństwa — zalecana dla aplikacji produkcyjnych.

Plesk oferuje kilka kluczowych parametrów konfiguracyjnych dla aplikacji Node.js, które wpływają na jej zachowanie i dostępność.

1. Document Root — katalog dokumentów domeny (musi być podkatalogiem katalogu głównego aplikacji).
2. Application Mode — wybierz tryb działania:
   • Production — tryb produkcyjny (zmienna NODE_ENV=production), zoptymalizowany pod kątem wydajności
   • Development — tryb deweloperski z bardziej szczegółowymi komunikatami błędów
   • Możesz też wpisać własną nazwę trybu
3. Application Root — katalog główny aplikacji. Domyślnie jest to katalog główny domeny. Kliknij ścieżkę, aby ją zmienić, lub kliknij „[open]", aby przeglądać katalogi przez Menedżer plików.
4. Application Startup File — plik startowy aplikacji. Domyślnie app.js. Kliknij, aby wpisać inną nazwę (np. server.js, index.js).
5. Custom environment variables (tylko Linux) — kliknij „[specify]", aby dodać zmienne środowiskowe. Kliknij Add variable i wpisz nazwę i wartość. Przydatne do konfiguracji połączenia z bazą danych, kluczy API itp.

Jeśli Twoja aplikacja korzysta z zewnętrznych pakietów npm (zdefiniowanych w pliku package.json), musisz je zainstalować przed uruchomieniem aplikacji. Plesk umożliwia to jednym kliknięciem.

1. Po skonfigurowaniu parametrów aplikacji kliknij OK, aby zapisać ustawienia.
2. Jeśli katalog aplikacji zawiera plik package.json, pojawią się przyciski NPM Install i Run Script.
3. Kliknij NPM Install, aby Plesk automatycznie uruchomił polecenie npm install i zainstalował wszystkie zależności z pliku package.json.
4. Poczekaj na zakończenie instalacji — czas zależy od liczby pakietów npm.
5. Po zakończeniu w katalogu aplikacji pojawi się folder node_modules z zainstalowanymi pakietami.

Po skonfigurowaniu wszystkich parametrów i zainstalowaniu zależności możesz uruchomić aplikację Node.js w Plesk.

1. Na ekranie konfiguracji Node.js kliknij przycisk Włącz Node.js (ang. Enable Node.js).
2. Plesk uruchomi Twoją aplikację Node.js.
3. Po uruchomieniu na stronie domeny pojawią się informacje o aplikacji: wersja Node.js, tryb działania i przycisk Restart App.
4. Kliknij link Application URL, aby otworzyć swoją aplikację w przeglądarce i sprawdzić, czy działa poprawnie.
5. Jeśli aplikacja nie startuje, sprawdź logi błędów (Witryny i domeny > Logi) dla szczegółów.