Документация

Быстрый старт

Зарегистрируйтесь на сайте (email или вход через Telegram), зайдите в личный кабинет → «Проекты» и нажмите «Новый проект». Выберите способ: ссылка на GitHub-репозиторий или готовый шаблон.

После деплоя проект появится в списке проектов со статусом. Логи и статус обновляются в реальном времени.

Деплой из терминала

Deployka CLI отправляет проект из терминала. Нужен Node.js 20 или новее. Пакет опубликован в beta, доступ к Deployka CLI API пока есть только у приглашённых QA-аккаунтов. Откройте папку проекта и выполните:

npx deployka login
npx deployka deploy

При первом входе откроется сайт Deployka. Сверьте код из терминала с кодом на экране, подтвердите, что вы сами запустили CLI, и вернитесь в терминал. Токен хранится в системном хранилище учётных данных; если оно недоступно, CLI отдельно спросит разрешение сохранить закрытый локальный файл.

Перед отправкой CLI показывает первые 30 файлов и размер ZIP, затем просит подтверждение. `.env*`, ключи и учётные данные, `.git`, зависимости, сборки, кэши, симлинки и `.deployka` не отправляются. Лимит — 20 МБ и 300 файлов. ENV вводится отдельно скрытым вводом; локальные `.env` автоматически не читаются.

Первый запуск использует обычную проверку проекта и условия Free/Nano. При выборе платного предложения или очереди завершите шаг в кабинете. CLI не создаёт счёт и не списывает деньги.

npx deployka deploy
npx deployka status
npx deployka logs
npx deployka logout

Повторный `deploy` из этой папки обновляет связанный проект. Если сборка не запустилась, посмотрите очищенные от секретов логи. При истёкшем входе выполните `npx deployka login`; список устройств и отзыв доступа находятся в Настройках кабинета.

Если проверка проекта остановила запуск, исправьте указанную ошибку и повторите `npx deployka deploy`. Черновик останется в кабинете; при неудачном preflight счёт не создаётся.

Deployka CLI on npm

Подключение AI-агента через MCP

Сначала войдите через CLI под той же учётной записью ОС, от имени которой работает AI-агент. Добавьте сервер в MCP-конфигурацию клиента и замените cwd на абсолютный путь к проекту:

{
  "mcpServers": {
    "deployka": {
      "command": "npx",
      "args": ["--yes", "deployka-mcp"],
      "cwd": "/absolute/path/to/your/project"
    }
  }
}

MCP-сервер умеет изучить состав проекта, подготовить архив, запросить статус и показать логи. Перед отправкой исходников совместимый MCP-клиент должен запросить ваше подтверждение. Сервер не читает `.env`; оплату и выбор Free/Nano завершайте на сайте. Доступ к CLI API пока только по приглашению.

Deployka MCP on npm

Деплой через GitHub

Поддерживаются только публичные и приватные репозитории GitHub по HTTPS-ссылке (например https://github.com/owner/repo). Для приватных репозиториев укажите GitHub-токен с доступом на чтение.

Мы клонируем последний коммит ветки по умолчанию, ищем Dockerfile — если его нет, собираем образ автоматически на основе package.json/requirements.txt.

Подробнее: деплой с GitHub →

Хостинг по стекам

Отдельные посадочные страницы под реальные сценарии деплоя — с ENV, типичными ошибками и тарифами.

• Разместить Next.js на Deployka →
• Разместить Vite/React на Deployka →
• Разместить FastAPI на Deployka →
• Хостинг Telegram-ботов →
• Деплой с GitHub →
• Подготовить и задеплоить проект из ChatGPT →

Шаблоны — полный список

Все шаблоны ниже разворачиваются без своего кода — выберите шаблон, заполните нужные переменные окружения и нажмите Deploy. На странице «Шаблоны» шаблоны с одной переменной деплоятся сразу после её заполнения (one-tap), без прохождения всего мастера.

Для каждого шаблона есть отдельный подробный гайд — пошагово, с картинками-подсказками где взять каждый токен, что нажимать и как проверить, что всё заработало. Эти ссылки можно смело давать людям, которые вообще не разбираются в деплое.

OpenClaw и Hermes Agent деплоятся one-tap так же, как остальные шаблоны — мы клонируем настоящий upstream-репозиторий проекта (github.com/openclaw/openclaw и github.com/NousResearch/hermes-agent соответственно, у каждого свой Dockerfile) и собираем его с вашими переменными окружения. Это реальные сторонние агентские фреймворки, а не наш форк — обновления подтягиваются из оригинального репозитория при каждом деплое.

Готовые примеры: что заполнить для каждого типа шаблона

Ниже — по одному разобранному примеру на каждую категорию шаблонов: что вводится в форму и что происходит при деплое.

Переменные окружения

Задаются в форме создания проекта как пары ключ-значение. Имена — только заглавные латинские буквы, цифры и подчёркивание. Значения хранятся зашифрованными и передаются в контейнер при запуске.

Свой код: GitHub или ZIP — какие файлы нужны

Если не используете шаблон — деплойте свой код через ссылку на GitHub-репозиторий или загрузив .zip-архив (кнопка «Загрузить ZIP» в мастере создания проекта). Мы ищем Dockerfile в корне; если его нет — собираем автоматически по маркерному файлу стека.

Проще всего: возьмите Dockerfile из любого шаблона на вашем стеке в разделе выше и адаптируйте под свой код — все они проверены и реально собираются.

Ограничения ZIP: до 20 МБ, до 300 файлов. Вложенные папки сохраняются. Симлинки пропускаются; абсолютные пути и `..` отклоняются.

Telegram-бот и кабинет

Войдите через кнопку «Login with Telegram» на сайте, чтобы привязать аккаунт. После этого откройте бота и отправьте /cabinet — увидите список своих проектов с кнопками Start/Stop/Restart и Logs прямо в чате.

Команда /support создаёт тикет прямо из чата, /tickets показывает историю обращений и позволяет ответить в существующий тикет. Ответ администратора придёт в Telegram и будет виден в кабинете. Команда /status показывает, что бот на связи.

Биллинг и оплата

Баланс списывается ежемесячно за каждый активный проект по цене выбранного тарифа. Пополнить баланс можно в кабинете через Telegram Stars или крипту (Heleket, CryptoBot).

При недостатке средств проект приостанавливается, но не удаляется — пополните баланс, и он снова заработает.

Проект не запускается — что делать?

Проверьте логи проекта в личном кабинете или через /cabinet → Logs в Telegram — там видна причина падения (отсутствующая переменная окружения, ошибка в коде, неверный старт-скрипт).

Разобрать BOT_TOKEN, webhook, OOM и ошибку сборки →

Если не разобрались сами — откройте тикет в поддержку или воспользуйтесь бесплатным сканом Deploy Doctor на странице Deploy Doctor — он находит частые причины проблем с деплоем.