# Instalacja

> Palladin documentation · 1.0 · PL · 2026-10-25


## Instalacja przez npm

Potrzebujesz Node.js 20.5.0 lub nowszego oraz npm 9.7.1 lub nowszego. Otwórz terminal na komputerze lub serwerze, na którym działa agent:

```sh
npm install --global @palladin/cli
```

Instalacja udostępnia polecenie `palladin`. Pakiet uruchamia natywny runtime dopasowany do wersji CLI i systemu operacyjnego.

## Sprawdzenie instalacji

```sh
palladin --version
palladin doctor
```

`--version` pokazuje wersję CLI. `doctor` sprawdza runtime i dostęp do systemowego magazynu kluczy. Nie rejestruje agenta ani nie przyznaje dostępu do sejfu.

Jeśli terminal nie rozpoznaje `palladin`, otwórz nową sesję i sprawdź, czy katalog globalnych programów npm znajduje się w `PATH`. Więcej w [rozwiązywaniu problemów](/pl/docs/developers/troubleshooting).

## System i magazyn kluczy

Wydanie CLI 0.0.9 udostępnia natywny runtime dla macOS Apple Silicon i Linux. Windows oraz macOS Intel nie są dostępne w tym wydaniu. Wymaga dostępu do systemowego magazynu kluczy. Nie uruchamiaj go z `sudo` tylko po to, by ominąć błąd uprawnień: agent powinien działać jako docelowy użytkownik systemu.

### Hardened a Convenience

**Hardened — zalecany tryb ochrony Palladina.** Wykorzystuje mechanizmy systemowe ograniczające dostęp innych procesów do kluczy i poświadczeń agenta. Nie chroni jednak przed przejęciem całego systemu ani przed programem, któremu udzielisz dostępu do sekretu.

**Convenience — tryb o ograniczonej izolacji.** Używa systemowego magazynu kluczy i wymaga zaufania do innych procesów działających na tym samym koncie systemowym. Złośliwy proces może uzyskać dostęp do poświadczeń lub ich użycia. Na Linuxie Secret Service nie rozróżnia procesów działających z tym samym identyfikatorem użytkownika.

Nazwy Hardened i Convenience określają poziomy ochrony Palladina, nie certyfikację ani branżowy standard. Apple Hardened Runtime to osobny mechanizm macOS; sam nie opisuje całej ochrony kluczy w Palladin.

| Platforma | Instalacja i ochrona |
| --- | --- |
| macOS Apple Silicon | Oficjalny pakiet npm zawiera podpisany runtime Hardened. Odczyt poświadczenia organizacji wymaga obecności użytkownika. |
| Linux | W wydaniu CLI 0.0.9 instalacja npm korzysta z Convenience i Secret Service. Broker Hardened nie jest częścią tego wydania. |
| Windows / macOS Intel | Brak publicznego pakietu runtime w wydaniu 0.0.9. |

Sprawdź wynik `palladin doctor` przed podłączeniem agenta. Jeśli Twoje środowisko wymaga Hardened, nie zastępuj go Convenience. Samo powodzenie `npm install` nie potwierdza poziomu ochrony.

## Aktualizacja

```sh
npm install --global @palladin/cli@latest
palladin --version
palladin doctor
```

Zachowaj istniejące profile. Jeśli korzystasz z MCP, uruchom ponownie jego serwer po aktualizacji.

## Następny krok

[Podłącz agenta do swojego panelu](/pl/docs/developers/connect). Zalecamy korzystanie z CLI. MCP jest opcją dla aplikacji, które wymagają tego interfejsu.