Check its license. It has its own license: read it before using it for work.

Is twenty still maintained?

Yes, active. Last change today. Latest release twenty/v2.56.1, yesterday.

Widely used. 61k stars, 3 years old, by an organization. As with any download, get it from the official repo.

gitmanual

Reading the repo

Opening the box…

How to install twenty on macOS (twentyhq/twenty) · gitmanual

How to install on macOS

twentyhq/twenty

The open alternative to Salesforce, designed for AI.

Node.js#crm#crm-system#customer#good-first-issue

Difficulty: Moderate
Time: about 15 min
Stars: ★ 60,601
Activity: Updated this month
License: Not detected
Open issues: 133
Got it running: Be the first
Looked up: 4 h ago

Saved setup from 4 h ago

Before you start

Is it free?: Check its licenseIt has its own license: read it before using it for work.
Still maintained?: Yes, activeLast change today. Latest release twenty/v2.56.1, yesterday.
Can I trust it?: Widely used61k stars, 3 years old, by an organization. As with any download, get it from the official repo.

Start here

Website ↗twenty.comThe project's own site.

Will it work on my device?

Yes, it installs on your macOS

The README gives a npm install for macOS.

Checking for

macOS Windows Linux

Install with a package manager

npm

npm install -g twenty

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Node.js 26.12.1runtime
1×yarn yarn@4.18.1package manager
1×Redis service

16× settings in .env

TAG
SERVER_URL
STORAGE_TYPE
REACT_APP_SERVER_BASE_URL
VITE_BUILD_SOURCEMAP
FRONTEND_BASE_URL
DEFAULT_LOGIN
DEFAULT_PASSWORDsecret
WEBSITE_URL
NODE_ENV
PG_DATABASE_URL
REDIS_URL
APP_SECRETsecret
SIGN_IN_PREFILLED
IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS
FRONTEND_URL

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/twentyhq/twenty/badge.svg)](https://gitmanual.com/twentyhq/twenty)

Good to know

Monorepo (workspaces) — install from the repo root.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: packages/create-twenty-app/package.json, packages/twenty-agent-skills/package.json, packages/twenty-apps/examples/document-generator/package.json, packages/twenty-apps/examples/hello-world/package.json and 11 more

package.json scripts (7)

docs:generatetsx packages/twenty-docs/scripts/generate-docs-json.ts
docs:generate-navigation-templatetsx packages/twenty-docs/scripts/generate-navigation-template.ts
docs:generate-pathstsx packages/twenty-docs/scripts/generate-documentation-paths.ts
docs:prune-orphanstsx packages/twenty-docs/scripts/prune-orphan-translations.ts
docs:fix-linkstsx packages/twenty-docs/scripts/fix-translated-links.ts
docs:restore-attributestsx packages/twenty-docs/scripts/restore-translated-attributes.ts
startnpx concurrently --kill-others 'npx nx run-many -t start -p twenty-server twenty-front' 'npx wait-on tcp:3000 && npx nx run twenty-server:worker'

Files we read (14)

.github/CONTRIBUTING.md

.github/workflows/ci-agent-skills-drift.yaml

.github/workflows/ci-agent-skills.yaml

.github/workflows/ci-ai-catalog-sync.yaml

.github/workflows/ci-app-docs-drift.yaml

.github/workflows/ci-blocked-contributors.yaml

.github/workflows/ci-breaking-changes.yaml

.nvmrc

README.md

package.json

packages/twenty-docker/.env.example

packages/twenty-e2e-testing/.env.example

packages/twenty-front/.env.example

packages/twenty-server/.env.example

Branch main · 37,793 files in the repo (large repo, list truncated)