Запуск Space
Для создания и выполнения заданий нужен работающий Orpheus с профилем агента и шаблоном AgentBox. Space использует отдельную PostgreSQL БД. Сборка образов не требуется: пример запускает опубликованные образы API, worker и веб-интерфейса.
Локальный интерфейс
В клоне репозитория документации:
cd examples/space
cp .env.example .envЗаполните POSTGRES_PASSWORD и ORPHEUS_SPACE_API_KEY в .env разными случайными значениями. Для каждого можно выполнить openssl rand -hex 32. Это параметры Compose: первый используется в DSN, второй — в списке ключей Space.
docker compose config --quiet
docker compose pull
docker compose up -d db migrate api web
curl -fsS http://localhost:9110/readyОткройте http://localhost:8086. В этом примере включён режим anonymous: интерфейс разрешает чтение и запись без входа, порты доступны только с локального компьютера. Открывайте именно localhost, поскольку ORPHEUS_PUBLIC_URL должен совпадать с origin браузера.
Перед созданием задания подключите Orpheus: Space проверяет профиль и шаблон по его каталогам. Без подключения можно просматривать сохранённые задания и проверять расписание. Без worker задания не выполняются.
Подключите Orpheus
Если Orpheus запущен на той же машине по быстрому старту, используйте готовое локальное подключение. Оно работает через Docker-сеть без публикации дополнительных портов.
Для другого сервера задайте ORPHEUS_BASE_URL и ORPHEUS_API_KEY в .env. Адрес должен быть доступен из контейнеров Space, а ключ — входить в PUBLIC_API_KEYS Orpheus.
В space.toml выберите существующий профиль и шаблон AgentBox. В примере это default и codex. Затем:
docker compose up -d api worker
docker compose psДождитесь healthy у worker. Это подтверждает готовность процесса, но не связь с Orpheus. Её проверяет первое задание. Неверный адрес оставит срабатывание в состоянии «Отправляется» с core_unavailable.
Серверное размещение
Разместите веб-интерфейс на отдельном HTTPS-домене и включите SAML. Передайте ORPHEUS_SPACE_UPSTREAM внутренний origin Space API. Веб-образ проксирует /api/, /auth/ и /saml/ к Space. API-ключ в браузер не передаётся.
API и worker используют одинаковые DSN и настройки исполнения. Запускайте один worker. Системный порт 9100 оставьте во внутренней сети. Резервное копирование, проверки и обновление.