Установка

Debian / Ubuntu / Astra и другие deb-системы

sudo apt install ./freedome-mediaserver_<версия>_<arch>.deb ./freedome-tools_<версия>_<arch>.deb

Пакет создаёт системного пользователя freedome, каталоги /var/lib/freedome и /etc/freedome/secrets, ставит conffile /etc/freedome/mediaserver.toml и защищённый unit freedome-mediaserver.service (Type=notify, watchdog, песочница). При первой установке генерируется ключ администратора /etc/freedome/secrets/mediaserver-admin.key (0640, root:freedome); в журнал пишется только его id.

sudo cat /etc/freedome/secrets/mediaserver-admin.key        # fdk_<id>_<secret>
curl -fsS http://localhost:8080/ready

Пакет заменяет старый freedome-core 2.x. apt purge удаляет конфигурацию и ключ; данные в /var/lib/freedome удаляются только при FREEDOME_PURGE_DATA=1. Рекомендуется ffmpeg (анализ медиа и превью). Перезагрузка / выключение хоста через API — только с пакетом freedome-mediaserver-power и [system] host_power = true.

RPM (Rocky / Alma / РЕД ОС)

sudo dnf install ./freedome-mediaserver-<версия>.<arch>.rpm ./freedome-tools-<версия>.<arch>.rpm

Docker

docker compose -f packaging/docker/docker-compose.demo.yml up -d
curl -fsS http://127.0.0.1:8080/ready

Демо-стенд: медиасервер + настоящий визуальный движок (freedome/engined, программный рендер) через Unix-сокет на общем томе.

Windows и macOS

Windows: MSI, служба FreedomeMediaServer, данные в %ProgramData%\Freedome. macOS: .pkg с LaunchDaemon, пользователь _freedome. Собираются в CI, на реальных машинах ещё не проверены; подписанные пакеты — с первым релизом.

Порты

Порт	Назначение
8080/tcp	HTTP: REST /api/v1, GraphQL, WebSocket, socket.io, /health, /ready, /metrics, Swagger UI /api/docs
7000/udp, 7000/tcp	OSC (UDP, TCP SLIP)
7001/udp	ответы и рассылки OSC
50062/tcp	gRPC (по умолчанию только Unix-сокет)
3000/tcp	необязательный порт для старых приложений ([legacy] listen_3000)