Архивная версия статьи — версия продукта 2.48.0, проверена 18 октября 2026 г.. Инструкции могли устареть.Актуальная статья →
CRM и продажи

Twenty CRM

CRM для B2B-продаж на своем сервере: клиенты, сделки и связанные с ними договоры в бесплатной редакции. Развернули 2.48.0 на Fatmetal Cloud Server, замерили ресурсы и проверили создание полей и связей.

Проверено на версии v2.48.0, 18 октября 2026~11 минут чтенияFatmetal Team

Вердикт

Подходит
  • Отделу B2B-продаж, которому тесно в таблице «клиент - сделка» и нужны свои связанные договоры.
  • Интегратору, который настраивает структуру CRM через интерфейс и оставляет базу у заказчика.
Не подходит
  • Бухгалтерии, которой нужны проведение документов и регламентированный учет.
  • Отделу маркетинга, который рассчитывает на бесплатные кампании в self-hosted редакции.
Проверенный тариф: CPU4-RAM8-DISK100Сложность: mediumЗапуск с готовыми образами: около 3 минутГлавный риск: незапущенный worker при долгих миграциях
Что это

Что это и какую задачу решает

Если клиентская база, сделки и договоры лежат на разных листах, менеджеру приходится искать связанные строки и сверять названия клиентов. В Twenty эти записи связаны: из карточки клиента можно открыть его сделки и договоры.

Например, у компании «Северный Маяк» видны контакт Ирина Волкова, сделка «Поставка оборудования» и договор ДП-2026-018. Из договора можно перейти обратно к компании или сделке, а не искать их заново по названию.

Договор хранится отдельной записью: у него свои сумма и дата окончания. Такой объект добавляется через «Модель данных» и связывается с существующими компаниями и сделками. Таблица и канбан показывают те же записи разными способами.

https://ваш-домен
Карточка компании с Ириной Волковой, сделкой «Поставка оборудования» и договором ДП-2026-018.
Компания «Северный Маяк»: связанные контакт, сделка и договор

Все записи демонстрационные. Объект и поля созданы через интерфейс Community без корпоративного ключа. Сумма сделки и договора - 1,2 млн рублей; названия и значения сохранились после перезагрузки страницы.

https://ваш-домен
Канбан со сделкой «Поставка оборудования» на 1,2 млн RUB; стартовые демосделки сохранены.
Канбан сделок: сумма в рублях, компания и контакт
2.14.0 → 2.48.0

Что изменилось с прошлого разбора

Между 2.14.0 и 2.48.0 изменились формы создания записей и настройки. API, вебхуки и приложения находятся в «Разработчиках», MCP - в разделе «ИИ». Производственная установка по-прежнему содержит четыре сервиса.

С 2.34 нужен PostgreSQL 15 или новее; здесь сохранен PostgreSQL 16. Обновились переменные подключения к базе и хранилищу, условия лицензирования расширений и платные ограничения кампаний.

Старая 2.14.0 затронута критической уязвимостью, исправленной в 2.15.0. Детали и другие исправления - в таблице уязвимостей. Перед обновлением сохраните базу, файлы и ключи.

Сравнение

Чем отличается от платных CRM

У Community нет платы за рабочее место: расходы переходят в сервер, обновления и резервные копии. Это полезно, когда нужны свои объекты и прямой контроль над базой.

ПродуктПубличная ставка за месяцЧто выбирает покупатель
Twenty Community0 за лицензию ядра; сервер отдельноСвоя модель данных и самостоятельное обслуживание
Twenty Cloud Pro$9 за пользователя при годовой оплатеОблако вендора
Salesforce Starter Suite$25 за пользователяКоммерческая платформа
HubSpot Sales Hub Starter$9 за место при годовой оплатеОблачная CRM
Pipedrive LiteОт $14 за место при годовой оплатеОблачная воронка продаж

Ставки проверены 18 октября 2026: Twenty, Salesforce, HubSpot, Pipedrive. Наборы функций различаются; это ориентиры расходов, а не равнозначные комплектации.

Salesforce ограничивает отношения с российскими клиентами, Pipedrive объявлял приостановку сервиса в России и Беларуси. Международная цена не означает доступный заказ из РФ. Свой сервер Fatmetal оплачивается в рублях.

Под капотом

Как устроен стек и сколько ресурсов выделить

Server отдает интерфейс React и API NestJS, worker выполняет фоновые задания. PostgreSQL хранит записи, Redis обслуживает очередь и кеш. Оба процесса Twenty используют один образ, но память расходуют отдельно.

В production compose нет ClickHouse. HTTPS здесь завершает отдельный Caddy; порт приложения 3000 доступен только на localhost. Постоянные данные лежат в томах PostgreSQL и локальных файлов Twenty.

ВыборДля этого разбора
ОСUbuntu 24.04 LTS
Рекомендуемый тарифCPU4-RAM8-DISK100: 4 vCPU, 8 ГБ, 100 ГБ
Цена сервера1100 руб/мес на дату проверки
СоставTwenty 2.48.0, PostgreSQL 16.15, Redis 7.4.11, Caddy 2.11.7

Рекомендация основана на импорте компаний и запуске: краткий пик превысил два ядра. Диск имел большой запас - система заняла около 5,3 ГБ. Сначала загрузите пробную клиентскую базу: потребление зависит от состава ваших данных.

В маркетплейсе Fatmetal

Не хотите ставить руками?

Этот стек есть в маркетплейсе Fatmetal - можно не повторять установку из этого разбора вручную. Заказываете сервер, за пару минут получаете рабочий домен, валидный TLS и файл с доступами.

Рекомендуемая конфигурация: CPU4-RAM8-DISK100

В маркетплейс →
Установка

Развертывание на Fatmetal Cloud Server

  1. Установите Docker на чистую Ubuntu

    На чистой Ubuntu войдите по SSH и выполните sudo -i. Направьте ваш-домен на сервер, откройте TCP80/443.

    curl -fsSL https://get.docker.com -o /tmp/get-docker.sh
    sh /tmp/get-docker.sh
    mkdir -p /opt/twenty && cd /opt/twenty
  2. Возьмите compose именно из релиза

    Работайте в /opt/twenty. Исходник закреплен тегом релиза.

    curl -fsSL https://raw.githubusercontent.com/twentyhq/twenty/twenty/v2.48.0/packages/twenty-docker/docker-compose.yml -o docker-compose.yml
    sed -i 's/"3000:3000"/"127.0.0.1:3000:3000"/; s/postgres:16$/postgres:16.15-bookworm/; s/image: redis$/image: redis:7.4.11-bookworm/; /test: curl --fail/a\      start_period: 300s' docker-compose.yml
  3. Задайте адрес и отдельные секреты

    Подставьте свой домен. Оболочка создаст разные секреты. Сохраните .env для восстановления.

    umask 077
    cat > .env <<EOF
    TAG=v2.48.0
    SERVER_URL=https://ваш-домен
    PG_DATABASE_NAME=default
    PG_DATABASE_USER=postgres
    PG_DATABASE_PASSWORD=$(openssl rand -hex 24)
    APP_SECRET=$(openssl rand -hex 32)
    ENCRYPTION_KEY=$(openssl rand -hex 32)
    STORAGE_TYPE=local
    DISABLE_DB_MIGRATIONS=false
    DISABLE_CRON_JOBS_REGISTRATION=false
    EOF
  4. Поднимите четыре сервиса

    Ожидание включает миграции. Предупреждения о незаданных S3-переменных допустимы при STORAGE_TYPE=local; не меняйте ключи при повторном запуске.

    docker compose pull
    docker compose up -d --wait --wait-timeout 600
    docker compose ps
    curl -fsS http://127.0.0.1:3000/healthz
  5. Включите HTTPS

    Caddy получит сертификат; для выдачи нужен открытый порт80.

    cat > /opt/Caddyfile <<'EOF'
    ваш-домен {
      reverse_proxy 127.0.0.1:3000
    }
    EOF
    docker run -d --name twenty-caddy --restart unless-stopped --network host -v /opt/Caddyfile:/etc/caddy/Caddyfile:ro -v caddy_data:/data -v caddy_config:/config caddy:2.11.7

Дождитесь выдачи сертификата: в docker logs twenty-caddy появится certificate obtained successfully. Откройте https://ваш-домен сразу после запуска. Создайте первый аккаунт, пароль и рабочую область: первый пользователь станет владельцем. Дождитесь подготовки рабочей области, заполните профиль; приглашение коллег можно пропустить. Затем выберите Settings → Experience → Language → Russian.

Создайте компанию и сделку, свяжите их через поле «Компания» и откройте повторно после обновления страницы.

Рабочий сценарий

Как добавить собственный договор

Откройте «Настройки → Модель данных → Добавить объект». Задайте «Договор» и «Договоры». Отключите синхронизацию меток с техническими именами и укажите contract/contracts.

Добавьте связь «Компания» типа Relation → Belongs to one: снимите «Возможности» и выберите «Компании». Для связи «Сделка» оставьте цель «Возможности». Перед сохранением закройте список целей.

Добавьте Currency с названием «Сумма», валютой RUB и форматом «Полный», затем Date «Дата окончания». Создайте договор и заполните обе связи. Названия типов остаются английскими даже при русской навигации.

https://ваш-домен
Настройки бесплатного кастомного объекта: отношения к компании и сделке, поле Currency и дата окончания.
Модель объекта «Договоры»: связи, сумма и дата

Чтобы изменить поле карточки, наведите на значение и нажмите появившийся редактор. После выбора связанной записи список закрывается сам. Договор станет виден и в обратной связи у компании.

https://ваш-домен
Рабочая карточка договора с суммой 1 200 000 RUB, датой 31.12.2026 и обычной историей изменений.
Договор ДП-2026-018: компания, сделка, сумма и дата окончания
Ресурсы

Что показали замеры

Стенд CPU4-RAM8-DISK100: Ubuntu 24.04.4, Docker 29.9.1, Compose 5.6.0. Импортировали CSV с тысячей компаний, получили 1006 записей, затем полностью перезапустили стек.

ПоказательРезультат
Память в простое после перезапускаОколо 2,0 ГиБ вместе с Caddy
Server / worker958 / 1022 МиБ
PostgreSQL / Redis / Caddy11 / 8 / 18 МиБ
Скачивание Twenty, PostgreSQL и Redis63 секунды
Повторный запуск до первого задания workerОколо 3 минут
Образ Twenty на диске1,85 ГБ
Рост базы от 1000 двухполевых компаний1,38 МиБ
Получение HTML по публичному HTTPSОколо 61 мс

Последняя строка показывает время получения HTML. Быстрый HTTP-ответ еще не означает готовность фоновых задач: worker закончил запуск позже сервера.

Первый запуск с диагностикой занял около восьми минут. Это запас на установку и разбор ошибки, а не обещание времени готовой карточки. Рост базы относится к компаниям с названием и доменом; вложения потребуют отдельного места.

Проверено 18 октября 2026 на Twenty 2.48.0. Замеры относятся к описанному набору данных и тарифу.

Диагностика

Где может сломаться

server unhealthy, worker Created

Причина. Миграции пустой базы идут дольше стандартного окна healthcheck. Worker ждет здоровый server.

Решение. В статье уже задан start_period: 300s. Посмотрите причину до повторного запуска:

cd /opt/twenty
docker compose logs --tail=80 server worker
docker compose up -d --wait --wait-timeout 600
SMTP не настроен: письмо восстановления не приходит

Причина. Режим logger оставляет письма в журнале. Регистрация работает, но это не доставка почты.

Решение. В server и worker раскомментируйте EMAIL_DRIVER/EMAIL_FROM_ADDRESS/EMAIL_SMTP_* из официального compose, заполните своим SMTP и пересоздайте контейнеры:

cd /opt/twenty
nano docker-compose.yml
docker compose up -d --force-recreate server worker

Используйте EMAIL_DRIVER=smtp, порт своего провайдера и его логин/пароль. На стенде доставку проверили через SMTP; для вашей установки нужны ваши реквизиты.

Интеграции

ИИ и доступ к внешней модели

ИИ-чат работает с внешним провайдером по вашему ключу. На стенде OpenRouter с моделью openai/gpt-4o-mini ответил через прокси Fatmetal; успешные ответы сохранены в интерфейсе.

i

Прокси к внешним API входит в стоимость сервера Fatmetal. Провайдера моделей выбираете вы.

Для server и worker добавьте одинаковый блок environment; NODE_USE_ENV_PROXY включает его использование встроенным HTTP-клиентом Node.

HTTP_PROXY: http://api-proxy.fatmetal.net:8080
HTTPS_PROXY: http://api-proxy.fatmetal.net:8080
NO_PROXY: localhost,127.0.0.1,10.0.0.0/8,172.16.0.0/12,db,redis,server,worker
NODE_USE_ENV_PROXY: "1"

Создайте /opt/twenty/ai.env с правами600 и своим ключом. Проверенная конфигурация для выбранной модели:

AI_PROVIDERS='{"stand":{"npm":"@ai-sdk/openai-compatible","name":"stand","label":"OpenRouter","baseUrl":"https://openrouter.ai/api/v1","apiKey":"ВАШ_КЛЮЧ","models":[{"name":"openai/gpt-4o-mini","label":"GPT-4o mini","contextWindowTokens":128000,"maxOutputTokens":4096,"inputCostPerMillionTokens":0.15,"outputCostPerMillionTokens":0.6}]}}'
AI_MODELS_DEFAULT_EXTRA_FAST=stand/openai/gpt-4o-mini
AI_MODELS_DEFAULT_FAST=stand/openai/gpt-4o-mini
AI_MODELS_DEFAULT_BALANCED=stand/openai/gpt-4o-mini
AI_MODELS_DEFAULT_SMART=stand/openai/gpt-4o-mini
AI_MODELS_DEFAULT_EXTRA_SMART=stand/openai/gpt-4o-mini

В обоих сервисах добавьте env_file: [ai.env] на уровне environment, затем выполните docker compose up -d --force-recreate server worker. Откройте «ИИ → Новый чат» и отправьте вопрос.

Ключ и выбранная модель задаются отдельно; прокси их не заменяет. Данные, отправленные в чат внешней модели, покидают вашу CRM. Не передавайте ей клиентские сведения без подходящего основания.

https://ваш-домен
Сохраненные ответы внешней модели на два арифметических запроса; успешные запросы через прокси Fatmetal.
ИИ-чат: ответы внешней модели через прокси

Раздел «Разработчики» содержит API, вебхуки и приложения. Настройки «ИИ → MCP» показывают адрес сервера для внешних клиентов; при выдаче API-ключа выбирайте нужную роль доступа.

https://ваш-домен
Раздел API на русском языке: выбор схемы и REST, песочница, пустой список ключей API.
Разработчики: API, вебхуки и приложения
Эксплуатация

Безопасность, копия и восстановление

Оставьте 3000 на localhost, используйте HTTPS и сохраните .env вместе с данными: потеря ENCRYPTION_KEY лишает доступа к зашифрованным секретам. Каталог /opt/twenty доступен администратору сервера.

Для согласованной копии остановите стек. Архив включает базу, локальные файлы и конфигурацию; он содержит секреты. Команды выполняются от root:

cd /opt/twenty
umask 077
docker compose stop
tar --numeric-owner -czf /root/twenty-backup.tgz -C / opt/twenty var/lib/docker/volumes/twenty_db-data/_data var/lib/docker/volumes/twenty_server-local-data/_data
docker compose up -d --wait --wait-timeout 600

Перенесите архив в закрытое хранилище вне этой машины. Восстановление ниже заменяет данные текущего инстанса; используйте ту же версию PostgreSQL и Twenty, что записана в архиве.

cd /opt/twenty
docker compose down
docker volume rm twenty_db-data twenty_server-local-data
docker compose create
tar --numeric-owner -xzf /root/twenty-backup.tgz -C /
docker compose up -d --wait --wait-timeout 600

Перед обновлением сделайте такую копию. Официальный порядок поддерживает прямой переход с версий от 1.23: миграции запускает server. После копии закрепите целевой релиз и дождитесь завершения:

cd /opt/twenty
docker compose down
sed -i 's/^TAG=.*/TAG=v2.48.0/' .env
docker compose pull
docker compose up -d --wait --wait-timeout 600

Не создавайте новый .env поверх действующей установки: сохраните прежние APP_SECRET и ENCRYPTION_KEY. После обновления войдите, откройте компанию и связанную сделку, проверьте worker по журналу. Ошибка миграции требует разбора лога или восстановления копии; смена тега назад не отменяет изменения базы.

Обновления

Уязвимости прошлых версий

Инструкция ставит 2.48.0 с перечисленными исправлениями. Для старой версии используйте порядок обновления выше; 2.14.0 оставлять публичной не стоит.

ИдентификаторУровеньЗатронутоИсправлено в TwentyЧто делать
CVE-2026-73069critical< 2.15.02.15.0Право DATA_MODEL позволяло выполнить SQL; при superuser возможны команды в контейнере базы.
GHSA-5p4m-2wfm-xmqj; GHSA-f88m-g3jw-g9cjhighЗависимости js-yaml / sharp из 2.14.0Подтверждено в 2.30.0Новые версии зависимостей устраняют опубликованные ошибки.
CVE-2026-14257; 69152; 69192highbrace-expansion / ip-address из старого lock-файлаПодтверждено в 2.30.0Старые расширения обновляйте отдельно.
CVE-2026-85055medium< 2.22.02.22.0Значение запрещенного поля раскрывалось через фильтрацию и число результатов.
CVE-2026-48930mediumNode.js 24.16.0 в образе Twenty 2.14.0; повторно в Twenty 2.19.12.19.0 (первое исправление); 2.20.0 (возвращено после отката 2.19.1)Обновите образ вместе с Node.js.
CVE-2026-53666; 53668; 53669mediumСтарые react-router / react-router-domПодтверждено в 2.43.0Обновлен маршрутизатор интерфейса.

Для зависимостей указан подтвержденный релиз с исправлением. Подробные диапазоны компонентов приведены в связанных бюллетенях и списках изменений.

Ограничения

Когда это НЕ ваш выбор

Нужны кампании и корпоративное разграничение

SSO, доступ по отдельным записям, Audit logs и маркетинговые кампании относятся к Organization/Enterprise. С 2.19 кампании self-host требуют лицензию; свою установку нельзя считать бесплатной заменой всего HubSpot.

Договор должен стать учетным документом

Наш объект хранит связи и реквизиты, а учетные документы и обмен с 1С потребуют отдельного решения. Если это основной процесс, выбирайте специализированный учет.

Операторам нужен полностью русский интерфейс

Навигация переведена, но новые типы полей, некоторые формы и демозначения остаются английскими. Оцените это на рабочих экранах до внедрения.

Ядро распространяется под AGPLv3 с Twenty Application Exception, отдельные SDK/UI/приложения - под MIT; корпоративные части имеют коммерческие условия. Исключение для Application Interfaces позволяет выбирать лицензию расширений, но не снимает AGPL с измененного ядра. Текст лицензии 2.48.0.

FAQ

Частые вопросы

Можно создать договор без платного ключа?

Да. На Community созданы объект contract, две связи, Currency в RUB и Date; запись сохранилась после обновления страницы.

Как переключить интерфейс на русский?

Settings → Experience → Language → Russian; после переключения раздел называется «Опыт работы». Формат даты и чисел выбирается отдельно.

Достаточно только контейнера server?

Нет. В проверенной установке есть отдельный worker; ему нужны здоровый server, PostgreSQL и Redis.

Как понять, что миграции закончились?

docker compose ps показывает healthy у server. Затем проверьте журнал worker и откройте записи через браузер.

История карточки - это платный Audit logs?

Нет. В карточке есть обычный таймлайн изменений; корпоративный журнал аудита - отдельная возможность.

Ключ модели входит в сервер?

Нет. В стоимость входит сетевой прокси, ключ и расход модели оплачиваются у выбранного провайдера.

Итог

Twenty Community подходит для B2B-базы, структуру которой вы хотите задавать сами. Компании, контакт, сделка и договор связаны через интерфейс; за эту модель не потребовался корпоративный ключ.

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

Анонсы новых разборов в Telegram-канале Новые гайды и карточки в маркетплейсе первыми @fatmetal_channel →

Этот стек у нас запущен на тарифе CPU4-RAM8-DISK100. Нашли баг в гайде - напишите, поправим в течение дня.