# Wdrożenie UI zarządzania Dockerem (Server UI)

Data: 2026-07-05 (aktualizacja: instalator control plane)  
Host: `gmktec-k11` (`192.168.100.90` — enp3s0)

## Kontekst

- Portainer usunięty 2026-07-04 — [`PORTAINER-REMOVAL.md`](PORTAINER-REMOVAL.md)
- Dockge usunięty 2026-07-04 — [`DOCKGE-REMOVAL.md`](DOCKGE-REMOVAL.md)
- **Własny panel:** [`stacks/server-ui/`](../stacks/server-ui/) — port **8091**
- **gpu-fan:** host agent :18090 (tylko systemd, bez Docker)

---

## Podsumowanie

| Element | Wartość |
|---------|---------|
| Stack | [`stacks/server-ui/`](../stacks/server-ui/) |
| Runtime native | systemd (`server-ui.service`) → `/opt/server-ui` |
| Runtime Docker | `docker compose --profile server-ui` (opcjonalnie) |
| HTTP | **http://192.168.100.90:8091** |
| Auth mutacji | `X-API-Key` — `/opt/control-plane/.env` (native) lub `stacks/control-plane/.env` (docker) |
| Stacki | `localai`, `vllm`, `comfyui`, `npmplus` |

**Server UI nie pojawia się w `docker ps` przy instalacji native** — to usługa systemd, nie kontener.

---

## Instalacja (zalecana)

```bash
cd ~/cursor/ubuntu-bare-metal/stacks/server-ui
sudo ./scripts/install-control-plane.sh
```

Menu: gpu-fan native (Y/n) + Server UI native (1) / Docker (2) / skip (3).

```bash
# Bez pytań: gpu-fan + server-ui native
sudo ./scripts/install-control-plane.sh -y

# Tylko Server UI Docker
sudo ./scripts/install-control-plane.sh --gpu-fan=no --server-ui=docker
```

### Tylko Server UI

| Tryb | Komenda |
|------|---------|
| Native | `sudo ./scripts/install.sh` |
| Docker | `sudo ./scripts/install-docker.sh` |

Klucze:
```bash
grep ^API_KEY= /opt/control-plane/.env
```

Tutorial: [`manual-tutorial/08-server-ui-install.md`](../manual-tutorial/08-server-ui-install.md)

---

## Pierwsze użycie

1. Otwórz **http://192.168.100.90:8091/?api_key=KLUCZ**
2. Karty stacków: Start/Stop, logi, edycja portów, linki (8070, 8188, …)
3. Zakładka **GPU Fan** — wymaga działającego `gpu-fan.service`

## Polityka GPU

RTX 3090 Ti 24 GB — jeden duży workload GPU naraz. API zwraca **409** przy konflikcie.

## Weryfikacja

```bash
# Native
systemctl status server-ui gpu-fan
curl -s http://127.0.0.1:8091/api/health

# Docker
docker compose --profile server-ui ps
curl -s http://127.0.0.1:8091/api/stacks
```

## Powiązane

- [`SERVER-UI-INSTALL-OPTIONS.md`](SERVER-UI-INSTALL-OPTIONS.md)
- [`SERVER-UI-PORT-CONFIG.md`](SERVER-UI-PORT-CONFIG.md)
- [`DOCKER-UI-HANDOFF.md`](DOCKER-UI-HANDOFF.md)
- [`stacks/server-ui/README.md`](../stacks/server-ui/README.md)