Настройка

Установка и обновление

Какой путь установки выбрать, как проверить сервер, как его обновить и что входит в резервную копию.

Здесь выбирается путь установки и описано то, что одинаково для всех путей: вход в CLI, проверка, обновление и резервная копия. Подробные шаги для каждого пути — на страницах, на которые ведут ссылки.

1. Выберите путь установки

Где будет работать серверКогда выбиратьЧто читать
Ваш компьютер (macOS или Linux)один человек, проба, модель помещается в памятьшаг 2 ниже, Cradle на вашем компьютере, Локальное развёртывание
Linux-серверобщая колыбель для нескольких людейшаг 3 ниже, Удалённый сервер
GPU-сервертяжёлые модели; консоль подключается через SSH-туннельКлючи и модели, GPU-сервер
Docker Composeсервер, Postgres, vLLM, SearXNG и файловое хранилище одним стекомшаг 4 ниже
Cradle cloudбез собственного серверашаг 5 ниже

2. Свой компьютер

Нужен curl. bun 1.4+ установщик поставит сам, если его нет. Без root: всё ложится в ~/.local/share/cradle.

curl -fsSL https://download.opencradle.ai/cradle-cli/latest/cradle-cli-install.sh | CRADLE_BIND=127.0.0.1 sh && ~/.local/bin/cradle-server --data-dir ~/.local/share/cradle/data --port 31416 --bind 127.0.0.1

Установщик распаковывает сервер, создаёт базу, пишет ключ в ~/.local/share/cradle/data/client-credentials.json и ставит команды cradle и cradle-server в ~/.local/bin. Если на машине есть пользовательская сессия systemd, он сам запускает сервер как службу, и вторая часть команды ответит, что порт занят, — так и должно быть.

Как проверить.

curl http://127.0.0.1:31416/api/v1/health

В ответе — "ok":true, "serverVersion":"0.9.2" и "kind":"local".

Если нет.

  • Нет ответа: сервер не запущен — выполните вторую часть команды (~/.local/bin/cradle-server …).
  • Порт занят: он уже занят службой (systemctl --user status cradle-server) или чужим процессом; другой порт — флаг --port.
  • cradle: command not found: добавьте ~/.local/bin в PATH.

3. Linux-сервер

curl -fsSL https://download.opencradle.ai/cradle-cli/latest/cradle-cli-install.sh | sudo sh

Под root установщик кладёт код в /opt/cradle, данные — в /var/lib/cradle, создаёт системную службу cradle-server и ссылки /usr/local/bin/cradle и /usr/local/bin/cradle-server. Ключ лежит в /var/lib/cradle/client-credentials.json. Установщик читает переменные CRADLE_PORT, CRADLE_BIND, CRADLE_DATA_DIR, CRADLE_USER, CRADLE_SERVICE, CRADLE_INSTALL_DIR и CRADLE_SKIP_SYSTEMD=1.

Без CRADLE_BIND=127.0.0.1 установщик привязывает сервер к 0.0.0.0:31416, то есть ко всем сетевым интерфейсам, и без TLS. Поставьте перед ним reverse proxy по странице удалённого сервера. Консоль считает колыбель, у которой API слушает не на 127.0.0.1, GPU-сервером — см. Ключи и модели.

Как проверить.

systemctl status cradle-server
curl http://127.0.0.1:31416/api/v1/health

Если нет. Журнал службы — journalctl -u cradle-server; для установки без root — journalctl --user -u cradle-server.

4. Docker

Стек описан в Docker Compose-файле клона репозитория: cradle-server, postgres (с pgvector), seaweedfs (файлы), searxng (поиск для агентов) и inference (vLLM — нужна NVIDIA GPU и nvidia-container-toolkit). Команды cradle server docker … ищут этот файл от корня репозитория, а архив установщика его не содержит, поэтому их запускают из клона репозитория Cradle:

bun run cli:dev server docker build
bun run cli:dev server docker up
bun run cli:dev server docker status

Остальные подкоманды — down, logs; запуск из клона через bun run cli:dev равен вызову cradle server docker ….

Ключ администратора печатается в журнал один раз при первом запуске:

bun run cli:dev server docker logs cradle-server | grep -i 'admin api key'

Порты по умолчанию: 31416 (API) и 31417 (MCP). Внешняя база вместо встроенного postgres — переменная DATABASE_URL и compose-файл внешней базы (он лежит рядом с основным compose-файлом стека в клоне репозитория) в CRADLE_COMPOSE_OVERRIDE.

Как проверить. docker compose … ps (или cradle server docker status) показывает сервисы запущенными, а curl http://127.0.0.1:31416/api/v1/health отвечает "ok":true.

Если нет. cradle server docker logs cradle-server — журнал сервера (команда logs держит поток открытым, выйти — Ctrl+C).

5. Cradle cloud

В консоли: Колыбели → карточка Cradle cloud → Подключить. Тариф Free работает с вашими ключами Claude, OpenAI и Kimi, Pro — с моделями из пула колыбели (Ключи и модели).

Как проверить. На карточке появляются кнопки Переподключить и Отключить, на странице «Команды» — команда.

Если нет. «Облако на этом сайте не настроено.» — сайт, на котором вы открыли консоль, не подключён к облаку. «Не удалось подключить: …» содержит причину; при ответе 403 not_a_member см. Вход, люди и ключи.

6. Войдите в CLI и проверьте сервер

Команды cradle — тонкий HTTP-клиент: они ходят к серверу с ключом. Возьмите поле apiKey из client-credentials.json (это ключ со скоупом admin:*):

cradle login --url http://127.0.0.1:31416 --key ck_live_...
cradle health

Как проверить. cradle login печатает ✓ saved as "default" — server http://127.0.0.1:31416 v0.9.2 и team: <slug>, cradle health — ✓ server … (v0.9.2) и строку agents: 0, models: 0, knowledge bases: 0.

Если нет.

  • error: unauthorized — неверный ключ.
  • error: ECONNREFUSED … — по этому адресу сервер не отвечает.
  • error: No server configured — cradle login ещё не выполнялся.

cradle login записывает адрес и ключ до проверки: при ошибке выполните его заново с правильными значениями. Несколько серверов — cradle servers list | use <имя> | remove <имя> и флаг --name у login.

7. Обновление

cradle update
cradle update --apply

Первая команда только проверяет: сравнивает версию с последним релизом и ничего не меняет. Вторая скачивает архив, сверяет SHA256, ставит зависимости и перезапускает службу.

Дополнительные флаги: --no-restart (не перезапускать службу), --service-name <имя> (по умолчанию cradle-server), --install-dir <путь>. Служба перезапускается через systemctl --user, если unit пользовательский, иначе через системный.

Как проверить. После --apply команда печатает ✓ updated to <версия> and restarted cradle-server, а cradle health показывает новую версию.

Если нет.

  • Внутри git-репозитория cradle update отказывается работать: там обновляют git pull && bun install.
  • Строка note: … failed … restart the server manually — служба не перезапущена: перезапустите её сами или перезапустите процесс cradle-server.
  • Консоль пишет «Сервер … устарел, нужен ≥ …» — обновите сервер этой командой.

8. Что входит в резервную копию

Копируйте каталог данных (~/.local/share/cradle/data, /var/lib/cradle или значение --data-dir), остановив службу на время копирования:

ЧтоЗачем
pgdata/встроенная база (PGlite). С DATABASE_URL базы здесь нет — снимайте pg_dump этой базы
secret.keyключ шифрования ключей провайдеров; без него (или без CRADLE_SECRET_KEY) сохранённые ключи не расшифровать
auth/issuer.keyключ подписи токенов людей; без него выданные токены перестанут действовать
app-state.json, skills-custom.jsonнастройки колыбели и свои скиллы
files/, skills/файлы ответов и пакеты скиллов
models/скачанные GGUF; их можно скачать заново

Файлы client-credentials.json и admin-key.txt содержат ключи — храните их как секреты.