Skip to main content
Get up and running with Twenty in minutes. Choose between our cloud offering for instant setup or self-host on your own infrastructure.

​
Cloud setup (fastest)

The quickest way to start using Twenty is with our cloud offering:
1

Sign up for Twenty Cloud

Visit twenty.com and click “Get Started” to create your account.
2

Create your workspace

Choose a workspace name and complete the onboarding flow. Your workspace will be ready in seconds.
3

Explore standard objects

Twenty comes with pre-configured objects like Companies, People, and Opportunities. Navigate to the Companies page to see your CRM in action.
4

Import your data

Click on any object view and use the import feature to upload a CSV file with your existing customer data.
Cloud workspaces include automatic backups, updates, and 99.9% uptime SLA.

​
Self-hosted setup (Docker)

For complete control over your data, deploy Twenty on your own infrastructure:
1

Prerequisites

Ensure you have Docker and Docker Compose installed on your system:
docker --version
docker compose version
2

Clone the repository

Download the Twenty Docker setup:
git clone https://github.com/twentyhq/twenty.git
cd twenty/packages/twenty-docker
3

Configure environment

Copy the example environment file and update with your settings:
cp .env.example .env
Edit .env and set at minimum:
SERVER_URL=http://localhost:3000
APP_SECRET=replace_me_with_a_random_string
Generate a strong random string for APP_SECRET. This secures your workspace data.
4

Start the services

Launch Twenty with Docker Compose:
docker compose up -d
This starts:
  • Server: Main application (port 3000)
  • Worker: Background job processor
  • Database: PostgreSQL 16
  • Cache: Redis
5

Access Twenty

Open your browser and navigate to http://localhost:3000. Create your first workspace and start using Twenty!

​
Docker service architecture

The docker-compose setup includes: 
services:
  server:   # Main application server
  worker:   # Background job processor
  db:       # PostgreSQL database
  redis:    # Cache and session storage
For production deployments, review our Self-hosting Guide for security, scaling, and backup recommendations.

​
Next steps

Customize your data model

Create custom objects and fields for your specific business needs

Set up workflows

Automate processes with triggers and actions

Configure permissions

Control who can access and modify your data

Explore the API

Integrate Twenty with your existing tools and systems

​
Getting help

If you encounter any issues: Welcome to Twenty! 🎉

Build docs developers (and LLMs) love

Get started for freeTalk to us