Twenty CRM
CRM для B2B-продаж на своем сервере: клиенты, сделки и связанные с ними договоры в бесплатной редакции. Развернули 2.56.1 на Fatmetal Cloud Server, замерили ресурсы и проверили свои поля, связи и приглашение по почте.
Вердикт
- Отделу B2B-продаж, который связывает договоры с клиентами и сделками вместо поиска строк на разных листах.
- Интегратору, которому нужно добавить собственные поля CRM без покупки корпоративного ключа.
- Бухгалтерии, которая ждет проведения документов и готового регламентированного учета.
- Владельцу старой установки, который хочет обновиться одной сменой тега без репетиции на копии базы.
Что это и какую задачу решает
В таблицах компания, сделка и договор часто живут на разных листах. Менеджер ищет совпадающие названия, переносит суммы и теряет контекст, когда клиент меняет реквизиты.
В Twenty клиент становится одной записью. К нему привязываются контакт, сделка и собственный объект «Договор». Из договора открывается нужная продажа; заново искать ее по названию не приходится.
У договора свои сумма и срок. Создать такой объект и связать его с клиентом и сделкой можно в бесплатной редакции Twenty.
Что изменилось с прошлого разбора
Предыдущая опубликованная статья описывала 2.48.0. В 2.56 формы создания записей включены для всех: сначала заполните боковую форму, затем подтвердите создание. Прежнее немедленное создание удалено.
С 2.51 заметки переведены с BlockNote на редактор TipTap; для старых текстов вендор требует отдельную миграцию. Вебхукам с 2.55 нужны роль и разрешение ROLES, а ИИ-шаги рабочих процессов с 2.56 получают собственную конфигурацию и права.
Образ перешел с Node 24.19.0 на 26.12.1. PostgreSQL 16, четыре сервиса и лицензия сохранились. Обновились зависимости и защита истории скрытых полей; исправления разобраны ниже.
Переход с 2.48.0 на тестовой копии остановился на проверке исторической миграции, хотя сервер отвечал. Планируйте репетицию с резервной копией, а не замену тега сразу на рабочей базе.
Чем отличается от платных CRM
Community не считает рабочие места. Вы платите за сервер и обслуживание; изменение структуры учета остается вашей задачей. Облако вендора берет на себя эксплуатацию и считает пользователей.
| Продукт | Публичная ставка за месяц | Что оплачивается |
|---|---|---|
| Twenty Community | 0 за базовую лицензию | Сервер и сопровождение отдельно |
| Twenty Cloud Pro | $9 за пользователя, годовой режим | Облачная CRM |
| Salesforce Starter Suite | $25 за пользователя | Облачная платформа |
| HubSpot Sales Hub Starter | От $20 за Core Seat | Ставка продуктового каталога |
| Pipedrive Lite | $14 за пользователя, годовой договор | Облачная воронка продаж |
Цены проверены 7 ноября 2026: Twenty, Salesforce, HubSpot, Pipedrive. За десять мест арифметика дает $90, $250, от $200 и $140 соответственно; наборы функций различаются.
Salesforce ограничивает клиентские отношения в России, Pipedrive объявлял приостановку сервиса в России и Беларуси. Эти заявления не означают одинаковый технический запрет обеих CRM. Сервер Fatmetal оплачивается в рублях; для своих B2B-записей не нужен платеж зарубежному поставщику CRM.
Как устроен стек и какой сервер взять
Server отдает интерфейс React и API NestJS. Отдельный worker выполняет фоновые задания, включая почту. PostgreSQL хранит записи, Redis обслуживает очередь и кеш; оба процесса Twenty используют один образ.
HTTPS завершает Caddy, порт 3000 остается на localhost. ClickHouse для основной CRM не нужен: встроенная панель Logs отдельно просит его настроить. Добавлять этот сервис ради клиентов и сделок не требуется.
| Параметр | Проверенная конфигурация |
|---|---|
| ОС | Ubuntu 24.04.4 LTS |
| Тариф | CPU4-RAM8-DISK100: 4 vCPU, 8 ГБ, 100 ГБ |
| Цена сервера | 1100 руб/месяц на дату проверки |
| Компоненты | Twenty 2.56.1, PostgreSQL 16.15, Redis 7.4.11, Caddy 2.11.7 |
Вендор заявляет минимум 2 ГБ. Рекомендация выше основана на запуске и импорте: краткий пик превысил два ядра. Запас памяти и диска получается из состава готового тарифа, а не из платы за каждого сотрудника.
В маркетплейсе Fatmetal
Не хотите ставить руками?
Этот стек есть в маркетплейсе Fatmetal - можно не повторять установку из этого разбора вручную. Заказываете сервер, за пару минут получаете рабочий домен, валидный TLS и файл с доступами.
Рекомендуемая конфигурация:
4 vCPU · 8 ГБ RAM · 100 ГБ NVMe от 990 ₽/мес
Развертывание на Fatmetal Cloud Server
Нужны чистая Ubuntu 24.04, доступ root и домен с A-записью сервера. Команды рассчитаны на новую установку; существующий .env с ключами не заменяйте.
Установите Docker на чистую Ubuntu 24.04
Откройте SSH и станьте root командой sudo -i. Docker запускает четыре сервиса приложения; OpenSSL создаст независимые секреты.
apt-get update && apt-get install -y ca-certificates curl openssl curl -fsSL https://get.docker.com -o /root/get-docker.sh sh /root/get-docker.sh docker compose versionСкачайте Compose именно 2.56.1
Тег фиксирует релиз. PostgreSQL оставляем в ветке 16; Redis тоже закрепляем, чтобы обновление образов не меняло весь стек одновременно.
install -d -m 700 /opt/twenty && cd /opt/twenty curl -fsSL https://raw.githubusercontent.com/twentyhq/twenty/twenty/v2.56.1/packages/twenty-docker/docker-compose.yml -o docker-compose.yml sed -i 's/image: postgres:16$/image: postgres:16.15-bookworm/;s/image: redis$/image: redis:7.4.11-bookworm/' docker-compose.ymlСоздайте конфигурацию и секреты
Замените ваш-домен на имя с A-записью сервера. Сохраните .env: потеря ENCRYPTION_KEY означает потерю доступа к зашифрованным реквизитам интеграций.
umask 077 cat > .env <<EOF TAG=v2.56.1 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) FALLBACK_ENCRYPTION_KEY= REDIS_CACHE_PREFIX=twenty STORAGE_TYPE=local DISABLE_DB_MIGRATIONS=false DISABLE_CRON_JOBS_REGISTRATION=false IS_MULTIWORKSPACE_ENABLED=false IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=false EMAIL_DRIVER=logger TZ=Europe/Moscow 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 EOFЗакройте порт приложения и дайте миграциям время
Дополнение передает .env обоим процессам и оставляет порт 3000 только на localhost. Пятиминутная отсрочка healthcheck нужна для холодных миграций.
cat > docker-compose.override.yml <<'EOF' services: server: ports: !override ["127.0.0.1:3000:3000"] env_file: .env healthcheck: {start_period: 300s} worker: env_file: .env redis: command: ["redis-server", "--maxmemory-policy", "noeviction", "--appendonly", "yes"] volumes: ["redis-data:/data"] volumes: redis-data: EOF docker compose pull && docker compose up -d --wait --wait-timeout 600Включите HTTPS с защитой первого входа
Откройте TCP 80/443 в сетевом экране сервера. Временный пароль Caddy сохранится в /root/twenty-bootstrap-password; логин owner. Он закрывает регистрацию владельца от посторонних.
CADDY_PASSWORD=$(openssl rand -hex 16) printf '%s\n' "$CADDY_PASSWORD" > /root/twenty-bootstrap-password CADDY_HASH=$(docker run --rm caddy:2.11.7 caddy hash-password --plaintext "$CADDY_PASSWORD") cat > /opt/twenty/Caddyfile <<EOF ваш-домен { basic_auth { owner $CADDY_HASH } reverse_proxy 127.0.0.1:3000 } EOF docker run -d --name twenty-caddy --restart unless-stopped --network host -v /opt/twenty/Caddyfile:/etc/caddy/Caddyfile:ro -v caddy_data:/data -v caddy_config:/config caddy:2.11.7Создайте владельца и закройте создание рабочих пространств
Посмотрите временный пароль:
cat /root/twenty-bootstrap-password. Откройте https://ваш-домен и войдите как owner. Затем зарегистрируйте свою учетную запись CRM, создайте рабочую область и заполните профиль; приглашения пока пропустите. После завершения снимите временную защиту следующими командами.sed -i 's/^IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=.*/IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true/' .env docker compose up -d --wait --wait-timeout 600 sed -i '/ basic_auth {/,/ }/d' /opt/twenty/Caddyfile docker restart twenty-caddy docker compose exec -T server yarn command:prod upgrade:status --failed-only curl -fsS https://ваш-домен/healthz
Удаляйте защиту Caddy только после создания владельца. В выводе последней проверки нужны Instance Up to date и ноль workspaces behind/failed.
Как добавить договор со своими полями
После первого входа выберите Settings → Experience → Language → Russian. Создайте компанию, контакт и сделку. В форме сделки выберите компанию и контакт; после нажатия «Создать» откройте запись повторно.
Перейдите в «Настройки → Модель данных → Добавить объект». Назовите его «Договор»/«Договоры». Отключите «Синхронизация меток объектов и названий API» и задайте contract/contracts: это технические имена для интеграций.
Добавьте две связи типа «Принадлежит одному»: «Компания» к «Компаниям», «Сделка» к «Возможностям». Затем добавьте «Сумма» типа «Валюта» с RUB и «Дата окончания» типа «Дата».
Создайте договор, выберите обе связи и введите сумму. В карточке двойной клик по значению открывает редактор. Для даты календарь принял 12/31/2026; после Enter и перезагрузки сохранилось 31 декабря 2026.
Что показали замеры
На тарифе CPU4-RAM8-DISK100 импортировали CSV с тысячей компаний: счетчик вырос с 6 до 1006. Затем перезапустили четыре сервиса и дождались первой обработанной задачи worker.
| Показатель | Результат |
|---|---|
| Память в простое вместе с Caddy | 1,6 ГиБ |
| Server / worker | 694 / 894 МиБ |
| PostgreSQL / Redis / Caddy | 13 / 8 / 19 МиБ |
| Пик при импорте / при старте | 1,7 / 1,8 ГиБ |
| Скачивание трех образов приложения | Около 68 секунд |
| Первый HTTP / готовность worker после рестарта | Около 140 / 165 секунд |
| Образ Twenty по Docker inspect | 1,77 ГБ |
| Импорт 1000 компаний / рост базы | Около 6 секунд / 2,6 МиБ |
| Получение HTML по публичному HTTPS | Медиана около 44 мс |
Быстрый HTTP-ответ не означает готовности фоновых заданий. При импорте кратковременно использовалось 2,9 ядра. Показатели относятся к названиям и доменам компаний: для этого набора тариф имеет запас.
Первый ручной сетап занял около шести минут. Для самостоятельной установки выделите время на регистрацию владельца и проверку почты.
Проверено на версии v2.56.1, 7 ноября 2026. На новых версиях результаты могут отличаться.
Где может сломаться
Причина. Холодные миграции не уложились в окно проверки. Worker ждет готовности server. В инструкции уже задан start_period: 300s.
Решение. Прочитайте журнал перед повтором запуска:
cd /opt/twenty
docker compose logs --tail=80 server worker
docker compose up -d --wait --wait-timeout 600Причина. Установщик способен продолжить запуск после ошибки миграции. В тесте перехода с 2.48 проверка старого checkpoint оставила workspace в состоянии Behind.
Решение. Остановите перенос пользователей, проверьте статус и журнал; при Behind верните согласованную копию. Не исправляйте курсоры миграций вручную.
cd /opt/twenty
docker compose exec -T server yarn command:prod upgrade:status --failed-only
docker compose logs --tail=150 serverПричина. sed -i заменяет файл, а bind mount контейнера сохраняет прежнюю копию с паролем.
Решение. Перезапустите Caddy, как в последнем шаге установки:
docker restart twenty-caddyПочта, внешняя модель и интеграции
Для приглашений откройте «Настройки → Панель администратора → Config variables». Задайте EMAIL_DRIVER=smtp, EMAIL_FROM_ADDRESS и EMAIL_SMTP_HOST/PORT/USER/PASSWORD по реквизитам своего почтового провайдера. На стенде приглашение реально пришло по SMTP/587 с STARTTLS.
Пригласите собственный адрес через «Участники → Пригласить» и дождитесь письма. Режим logger из стартовой конфигурации оставляет сообщения в журнале; рабочую доставку включает ваш SMTP.
Прокси к внешним API входит в VPS Fatmetal; переменные уже переданы server и worker. Провайдера модели выбираете вы, его ключ и запросы оплачиваются отдельно. Проверенный диалог использовал OpenRouter и openai/gpt-4o-mini.
Для такого подключения допишите в .env свои значения ниже, заменив ВАШ_КЛЮЧ, затем пересоздайте процессы. Одна и та же конфигурация нужна обоим:
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-minicd /opt/twenty
docker compose up -d --force-recreate server workerОткройте «ИИ → Новый чат» и отправьте вопрос. Данные запроса уходят выбранному провайдеру: для клиентских сведений заранее определите допустимый состав. Ключ храните в закрытом .env вместе с резервной копией.
«Разработчики» объединяют API, вебхуки, приложения и команды для терминала. «ИИ → MCP» показывает адрес CRM для внешних клиентов; API-ключу назначайте роль с нужными правами.
Резервная копия, восстановление и обновление
Согласованная копия включает PostgreSQL, файлы, очередь Redis и конфигурацию с ключами. Остановите четыре сервиса, снимите архив и запустите их снова:
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 var/lib/docker/volumes/twenty_redis-data/_data
docker compose up -d --wait --wait-timeout 600Храните архив вне этого сервера с доступом только администратора. Восстановление ниже заменяет действующие данные; используйте те же образы Twenty и PostgreSQL, которые записаны в копии:
cd /opt/twenty
docker compose down
tar --numeric-owner -xzf /root/twenty-backup.tgz -C / opt/twenty
docker volume rm twenty_db-data twenty_server-local-data twenty_redis-data
docker compose create
tar --numeric-owner -xzf /root/twenty-backup.tgz -C /
docker compose up -d --wait --wait-timeout 600Для обновления сначала разверните копию отдельно. На ней измените TAG в .env, скачайте образ и проверьте миграции:
cd /opt/twenty
sed -i 's/^TAG=.*/TAG=v2.56.1/' .env
docker compose pull && docker compose up -d --wait --wait-timeout 600
docker compose exec -T server yarn command:prod upgrade:status --failed-onlyУспех означает Up to date у instance и всех workspaces. Затем откройте прежние заметки, связи и формы. Смена тега назад не откатывает базу; для возврата нужен архив с соответствующей конфигурацией.
Уязвимости прошлых версий
Инструкция ставит 2.56.1 с перечисленными исправлениями. Существующую базу обновляйте через репетицию и проверку статуса выше; прежний публичный релиз оставлять без исправлений опасно.
| Идентификатор | Уровень | Затронуто | Исправлено в Twenty | Условие и действие |
|---|---|---|---|---|
| CVE-2026-73069 | critical | Twenty <2.15.0 | 2.15.0 | Право DATA_MODEL допускало SQL; superuser БД усиливал последствия. |
| CVE-2026-105482, CVE-2026-105483, CVE-2026-106069, CVE-2026-111497 | high | Node 24 <24.22.1; 26 <26.12.1 (в Twenty 2.48 - 24.19.0) | 2.51.0: Node 26.12.1 | DNS с NUL, необычные IPv4/TLS или специально подготовленный Brotli. Обновляется весь образ. |
| GHSA-xjj6-f33q-929c | high | undici ≥6.23.0,<6.29.1; ≥7.18.0,<7.30.1; ≥8.0.0,<8.12.2 | 2.52.0 | Избыточные content-encodings в ответе внешнего сервера вызывают отказ. |
| CVE-2023-54404 | high | zod <4.6.6 | 2.53.1 | Огромная ограниченная коллекция на входе проверки расходует память. Старые собственные приложения обновляйте отдельно. |
| CVE-2026-109461 | high | MSAL Node 5.0.0-beta.0-<7.1.0 | 2.53.1 | Затронут auth_code flow; Twenty использует refreshToken/cache. |
| CVE-2026-116689 | high | follow-redirects 1.16.0-1.16.1 | 2.56.0 | Нужны cross-realm sensitiveHeaders и собственные секретные заголовки; Authorization/Cookie защищены. |
| GHSA-j86q-q8c2-f8x7 | medium | Twenty ≥1.4.0, <2.52.0 | 2.52.0 | История раскрывала значения скрытых полей; обновитесь перед разграничением доступа. |
Когда это НЕ ваш выбор
Отделу нужны кампании и корпоративные политики
SSO, доступ к отдельным записям, Audit logs и маркетинговые кампании относятся к платным возможностям. Собственный сервер не превращает их в бесплатную замену всего HubSpot.
Договор должен стать учетным документом
Свой объект хранит сумму, дату и связи. Проведение документов и регламентированный учет требуют другого решения; здесь мы собирали карточки продаж.
Операторам нужен полностью русский интерфейс
Навигация переведена, но форматы даты, демостадии и отдельные подписи остаются смешанными. Оцените рабочие экраны до переноса отдела.
Ядро лицензируется по AGPLv3 с Twenty Application Exception; toolkit, UI и приложения имеют MIT, корпоративные файлы - коммерческие условия. Исключение для интерфейсов расширений не отменяет AGPL для измененного ядра. Лицензия 2.56.1.
Частые вопросы
Можно создать свой договор бесплатно?
Да: объект contract, сумма RUB, дата и две связи созданы без корпоративного ключа. Значения сохранились после перезагрузки страницы.
Почему worker важен, если страница уже открывается?
Фоновые задания выполняет отдельный процесс. На заполненной базе HTTP отвечал через 140 секунд, первая задача worker завершилась через 165.
Где включить русский язык?
Settings → Experience → Language → Russian. Названия собственных стадий и формат даты задаются отдельно.
Как понять, что обновление завершено?
Команда upgrade:status --failed-only должна показывать Up to date и ноль behind/failed. Даже exit0 и healthy не заменяют этот результат.
Нужен ли ClickHouse для компаний и договоров?
Нет. Проверенный стек содержит четыре сервиса приложения; требование ClickHouse появляется при открытии отдельной панели Logs.
Итог
Twenty дает отделу продаж свою структуру учета: клиент, контакт, сделка и договор связаны, поля меняются через интерфейс. За этот сценарий корпоративный ключ не потребовался.
Для начала соберите один реальный договор и проверьте переходы между записями. Перед переносом базы отработайте резервную копию и восстановление: ошибка миграции может скрываться за работающей страницей.
Рекомендуемая конфигурация для установки:
4 vCPU · 8 ГБ RAM · 100 ГБ NVMe
Не хотите устанавливать вручную?
Запустите Twenty CRM на этой конфигурации автоматически - от 990 ₽/мес.
Этот стек у нас запущен на тарифе CPU4-RAM8-DISK100. Нашли баг в гайде - напишите, поправим в течение дня.