Twenty CRM

Twenty - система управления отношениями с клиентами с открытым исходным кодом. Команда строит ее как ответ на две проблемы коммерческих CRM: данные клиентов заперты внутри платформы, а цена растет вместе с числом мест. Twenty устанавливается на собственный сервер, данные остаются в вашей PostgreSQL, а интерфейс собран в духе Notion, Airtable и Linear - таблицы, kanban, фильтры, кастомные объекты и поля.

Это инструмент для продуктовых команд, отделов продаж и фаундеров, которым нужна управляемая воронка, карточки компаний и контактов, и при этом неприемлема подписка за каждого пользователя или хранение базы клиентов у внешнего вендора. Из коробки есть кастомные объекты и поля, роли и права, простые workflow с триггерами и действиями, а также интеграция почты, календаря и файлов.

Twenty - это TypeScript-монорепозиторий на Nx. Бэкенд написан на NestJS, использует PostgreSQL как основное хранилище, Redis для кеша и BullMQ для фоновых задач. Фронтенд - React (Jotai для стейта, Linaria для стилей, Lingui для локализации). В Docker Compose это раскладывается на четыре контейнера: server (API + отдача фронта), worker (фоновые задачи через BullMQ), db (postgres:16) и redis.

Сервер при первом старте сам прогоняет миграции БД и регистрирует фоновые задачи. Worker запускается отдельно и зависит от готовности сервера - это важная деталь для деплоя, к ней вернемся в разделе про подводные камни.

1. Создать VM

   Cloud Server, тариф CPU4-RAM8-DISK100, ОС Ubuntu 24.04 LTS, приложение Docker из маркетплейса. Docker и Compose ставятся через cloud-init при первом запуске.

2. Подготовить каталог и .env

   mkdir ~/twenty && cd ~/twenty
   curl -o docker-compose.yml \
     https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml
   curl -o .env \
     https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/.env.example

3. Сгенерировать секреты и задать переменные

   Сгенерируйте APP_SECRET и ключ шифрования, задайте пароль Postgres, закрепите версию образа и адрес доступа.

   # в .env
   APP_SECRET=$(openssl rand -base64 32)
   PG_DATABASE_PASSWORD=задайте_свой_пароль
   SERVER_URL=http://ВАШ_IP:3000
   TAG=v2.14.0

4. Поднять стек

   docker compose pull
   docker compose up -d

   Сервер сам прогонит миграции при первом старте. Дождитесь статуса healthy у контейнера server.

5. Проверить

   docker compose ps
   curl -s -o /dev/null -w "%{http_code}\n" http://localhost:3000/healthz   # ожидаем 200

   Интерфейс - на порту 3000, открывается и по http://IP:3000. Для продакшена поставьте обратный прокси с TLS (часть функций требует защищенного контекста) - об этом в разделе про безопасность.

http://ваш-домен:3000/objects/companies

http://ваш-домен:3000/objects/opportunities

По http приложение открывается и работает, но часть браузерных функций (например, копирование в буфер) по документации требует защищенного контекста - HTTPS либо localhost. Поэтому на проде ставьте обратный прокси с TLS. Минимальный рабочий вариант на Caddy:

# /etc/caddy/Caddyfile - Twenty за HTTPS
ваш-домен {
    reverse_proxy 127.0.0.1:3001
}

Caddy сам получит сертификат Let's Encrypt для домена. Twenty при этом слушает локальный порт (например, 3001), наружу торчит только Caddy. В .env приведите SERVER_URL к публичному адресу: SERVER_URL=https://ваш-домен - он должен совпадать с тем, как пользователи открывают приложение.

Релизы и security-advisories отслеживайте в репозитории (watch → releases). Обновление - смена тега и пересборка:

# обновление до новой версии
cd ~/twenty
sed -i 's/^TAG=.*/TAG=НОВАЯ_ВЕРСИЯ/' .env
docker compose pull
docker compose up -d        # миграции прогонятся автоматически

Перед обновлением снимайте дамп БД - откат сводится к восстановлению из дампа:

docker exec twenty-db-1 pg_dump -U postgres twenty > backup_$(date +%Y%m%d).sql

Часть файлов проекта - под Enterprise-лицензией Twenty (помечены /* @license Enterprise */), остальное под AGPLv3. Для коммерческого использования enterprise-функций нужна подписка - это стоит учитывать, если планируете дорабатывать и распространять форк.

• Обратный прокси с SSL - Caddy или Nginx Proxy Manager для HTTPS и корректного SERVER_URL.
• Бэкапы - pg_dump по cron + выгрузка дампов в S3-совместимое хранилище.
• Мониторинг - Grafana + Prometheus, чтобы держать под контролем память worker под нагрузкой.
• Почта и календарь - интеграция через Google / Microsoft OAuth для синхронизации писем и встреч.
• Объектное хранилище - S3-совместимый бакет под файлы и вложения вместо локального диска.
• Управление из AI-агента - есть открытый community-скилл twenty-crm-skill (MIT). Он дает AI-агенту (Claude Code, Cursor и другим по стандарту Agent Skills) читать и менять данные CRM - контакты, компании, сделки, задачи, заметки, кастомные объекты - прямо через REST API вашего Twenty. Под капотом генерирует CLI из OpenAPI-спеки воркспейса (ocli) и работает на любом деплое, включая self-hosted. Пригодится, чтобы автоматизировать рутину по базе и подключить CRM к agent-воркфлоу.