Обновлено 8 ноября 2026 г.
CRM и продажи

Twenty CRM

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

Проверено на версии v2.56.1, 7 ноября 2026~12 минут чтенияFatmetal Team
CRM и продажиЯдро: AGPLv3Проверено: v2.56.1

Вердикт

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

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

В таблицах компания, сделка и договор часто живут на разных листах. Менеджер ищет совпадающие названия, переносит суммы и теряет контекст, когда клиент меняет реквизиты.

В Twenty клиент становится одной записью. К нему привязываются контакт, сделка и собственный объект «Договор». Из договора открывается нужная продажа; заново искать ее по названию не приходится.

У договора свои сумма и срок. Создать такой объект и связать его с клиентом и сделкой можно в бесплатной редакции Twenty.

https://ваш-домен
Продажа Маяку на 1,2 млн RUB с компанией и Ириной Волковой; рядом стандартные демонстрационные сделки.
Канбан сделок: сумма в рублях, компания и контакт
2.48.0 → 2.56.1

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

Предыдущая опубликованная статья описывала 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 Community0 за базовую лицензиюСервер и сопровождение отдельно
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 с ключами не заменяйте.

  1. Установите 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
  2. Скачайте 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
  3. Создайте конфигурацию и секреты

    Замените ваш-домен на имя с 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
  4. Закройте порт приложения и дайте миграциям время

    Дополнение передает .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
  5. Включите 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
  6. Создайте владельца и закройте создание рабочих пространств

    Посмотрите временный пароль: 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 и «Дата окончания» типа «Дата».

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

Создайте договор, выберите обе связи и введите сумму. В карточке двойной клик по значению открывает редактор. Для даты календарь принял 12/31/2026; после Enter и перезагрузки сохранилось 31 декабря 2026.

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

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

На тарифе CPU4-RAM8-DISK100 импортировали CSV с тысячей компаний: счетчик вырос с 6 до 1006. Затем перезапустили четыре сервиса и дождались первой обработанной задачи worker.

ПоказательРезультат
Память в простое вместе с Caddy1,6 ГиБ
Server / worker694 / 894 МиБ
PostgreSQL / Redis / Caddy13 / 8 / 19 МиБ
Пик при импорте / при старте1,7 / 1,8 ГиБ
Скачивание трех образов приложенияОколо 68 секунд
Первый HTTP / готовность worker после рестартаОколо 140 / 165 секунд
Образ Twenty по Docker inspect1,77 ГБ
Импорт 1000 компаний / рост базыОколо 6 секунд / 2,6 МиБ
Получение HTML по публичному HTTPSМедиана около 44 мс

Быстрый HTTP-ответ не означает готовности фоновых заданий. При импорте кратковременно использовалось 2,9 ядра. Показатели относятся к названиям и доменам компаний: для этого набора тариф имеет запас.

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

Проверено на версии v2.56.1, 7 ноября 2026. На новых версиях результаты могут отличаться.

Диагностика

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

server unhealthy, worker Created

Причина. Холодные миграции не уложились в окно проверки. Worker ждет готовности server. В инструкции уже задан start_period: 300s.

Решение. Прочитайте журнал перед повтором запуска:

cd /opt/twenty
docker compose logs --tail=80 server worker
docker compose up -d --wait --wait-timeout 600
Warning: Upgrade completed with errors

Причина. Установщик способен продолжить запуск после ошибки миграции. В тесте перехода с 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
401 после удаления basic_auth

Причина. 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-mini
cd /opt/twenty
docker compose up -d --force-recreate server worker

Откройте «ИИ → Новый чат» и отправьте вопрос. Данные запроса уходят выбранному провайдеру: для клиентских сведений заранее определите допустимый состав. Ключ храните в закрытом .env вместе с резервной копией.

https://ваш-домен
Сохраненный ответ 17 + 26 = 43 из проверенного на deploy диалога через прокси Fatmetal; нового запроса не отправляли.
Ответ внешней модели в ИИ-чате

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

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

Резервная копия, восстановление и обновление

Согласованная копия включает 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-73069criticalTwenty <2.15.02.15.0Право DATA_MODEL допускало SQL; superuser БД усиливал последствия.
CVE-2026-105482, CVE-2026-105483, CVE-2026-106069, CVE-2026-111497highNode 24 <24.22.1; 26 <26.12.1 (в Twenty 2.48 - 24.19.0)2.51.0: Node 26.12.1DNS с NUL, необычные IPv4/TLS или специально подготовленный Brotli. Обновляется весь образ.
GHSA-xjj6-f33q-929chighundici ≥6.23.0,<6.29.1; ≥7.18.0,<7.30.1; ≥8.0.0,<8.12.22.52.0Избыточные content-encodings в ответе внешнего сервера вызывают отказ.
CVE-2023-54404highzod <4.6.62.53.1Огромная ограниченная коллекция на входе проверки расходует память. Старые собственные приложения обновляйте отдельно.
CVE-2026-109461highMSAL Node 5.0.0-beta.0-<7.1.02.53.1Затронут auth_code flow; Twenty использует refreshToken/cache.
CVE-2026-116689highfollow-redirects 1.16.0-1.16.12.56.0Нужны cross-realm sensitiveHeaders и собственные секретные заголовки; Authorization/Cookie защищены.
GHSA-j86q-q8c2-f8x7mediumTwenty ≥1.4.0, <2.52.02.52.0История раскрывала значения скрытых полей; обновитесь перед разграничением доступа.
Ограничения

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

Отделу нужны кампании и корпоративные политики

SSO, доступ к отдельным записям, Audit logs и маркетинговые кампании относятся к платным возможностям. Собственный сервер не превращает их в бесплатную замену всего HubSpot.

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

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

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

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

Ядро лицензируется по AGPLv3 с Twenty Application Exception; toolkit, UI и приложения имеют MIT, корпоративные файлы - коммерческие условия. Исключение для интерфейсов расширений не отменяет AGPL для измененного ядра. Лицензия 2.56.1.

FAQ

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

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

Да: объект 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 ₽/мес.

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

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