# HY2XS install package

Этот пакет создаётся production builder'ом на Debian 13 amd64.

Пакет предназначен для чистого Debian 13 target и содержит:

- compiled install-only orchestrator;
- bundled HY2XS admin;
- templates;
- systemd units;
- package metadata и checksums.

Запускать от root:

```sh
./install.sh --non-interactive
```

С внешним source-config:

```sh
./install.sh --config /root/custom-hy2xs.env --non-interactive
```

В baseline нет target-side JavaScript, TypeScript, frontend или Go build step.

## Установка выполняется в две фазы

```text
PHASE 0 — READ ONLY
  проверка прав и checksums пакета
  clean-host preflight из распакованного архива
        ↓  ноль изменений на сервере
PHASE 1 — MUTATION
  установка orchestrator, раскладка runtime-пакета
  install
```

HY2XS v1 **не устанавливается поверх** предыдущей установки и не мигрирует её
состояние. Если PHASE 0 обнаружит старую установку, установщик завершится с
ошибкой и **не изменит на сервере ничего**.

Проверить хост, ничего не устанавливая:

```sh
./orchestrator/hy2xs-orchestrator preflight-install --package-dir "$(pwd)"
```

Очистка предыдущей установки — отдельная явная операция оператора, она описана
в `docs/14-legacy-cleanup.md` репозитория проекта и выполняется скриптом
`tools/legacy/purge-v0.sh`. Установщик её никогда не запускает сам.