# Требования к системе

## Операционная система

* **Рекомендуется:** Debian 12 (Bookworm) или Raspberry Pi OS (Bookworm).
* **Архитектура:** `x86_64` или ARM (`arm64`, `armv7` — Raspberry Pi).

Образ клиента собирается под `linux/amd64`, `linux/arm64` и `linux/arm/v7`,
поэтому Raspberry Pi 3 и новее подходят.

## Программное обеспечение

Единственная зависимость на хосте — Docker и Docker Compose. Всё остальное
(GNU Radio, gr-satnogs, gr-satellites, драйверы SoapySDR) уже внутри образа.
Ставить GNU Radio на хост не нужно и не рекомендуется.

## Железо

* **SDR-приёмник** с поддержкой SoapySDR. Проверены и штатно настраиваются:
  Airspy (Mini / R2), RTL-SDR, HackRF, SDRplay (msi001/msi2500), LibreSDR.
* **Антенна** на нужный диапазон (чаще всего VHF 137–146 МГц и UHF 400–470 МГц).
* **Поворотное устройство** — опционально, см. [Поворотное устройство](rotator.md).
* **Трансивер** — опционально; по умолчанию клиент работает с фиктивным
  `rigctld` (Hamlib model `1`, dummy), который лишь принимает команды
  доплеровской коррекции.

### Ресурсы

Клиент — только оркестратор, но DSP внутри контейнера требует заметных
ресурсов:

* **ОЗУ:** от 2 ГБ. В `docker-compose.yml` контейнеру выделяется `shm_size: 1gb`
  под разделяемые буферы GNU Radio.
* **Диск:** ~4 ГБ под образ плюс запас под наблюдения. Рабочие файлы и логи
  лежат в томе `/var/lib/soniks-client` и переживают перезапуск контейнера.
  Выгруженные файлы с диска убираются, но невыгруженные ждут в `incomplete/`
  столько, сколько потребуется.
* **Сеть:** постоянный доступ к `https://sonik.space/api/`. Клиент опрашивает
  расписание раз в минуту и выгружает данные во время и после прохода.

```{note}
Если вы включаете запись IQ (`FLOWGRAPH__ENABLE_IQ_DUMP=True`, нужно для METEOR),
поток пишется на диск со скоростью в десятки мегабайт в секунду. Указывайте
`FLOWGRAPH__IQ_DUMP_FILENAME` на реальный диск с запасом места, а не в tmpfs.
```

## Точность времени

Расчёт положения спутника и доплеровского сдвига идёт от системных часов.
Убедитесь, что на хосте работает NTP (`timedatectl status` → `NTP service: active`).
Уход часов на несколько секунд смещает окно прохода и портит приём.