Установка и обновление
Какой путь установки выбрать, как проверить сервер, как его обновить и что входит в резервную копию.
Здесь выбирается путь установки и описано то, что одинаково для всех путей: вход в 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 содержат ключи — храните их
как секреты.