--- title: Configuración --- # Gestión de Configuración **¿Instalando por primera vez?** Siga la [guía de instalación de Docker Compose](/l/es/developers/self-host/capabilities/docker-compose) para ejecutar Twenty, luego regrese aquí para la configuración. Twenty ofrece **dos modos de configuración** para adaptarse a diferentes necesidades de implementación: **Acceso al panel de administración:** Solo los usuarios con privilegios de administrador (`canAccessFullAdminPanel: true`) pueden acceder a la interfaz de configuración. ## 1. Configuración del Panel de Administración (Predeterminado) ```bash IS_CONFIG_VARIABLES_IN_DB_ENABLED=true # predeterminado ``` **La mayoría de las configuraciones se realizan a través de la interfaz** después de la instalación: 1. Acceda a su instancia de Twenty (normalmente `http://localhost:3000`) 2. Vaya a **Configuración / Panel de Administración / Variables de Configuración** 3. Configure integraciones, correo electrónico, almacenamiento y más 4. Los cambios se aplican inmediatamente (dentro de 15 segundos para implementaciones multicontenedor) **Implementaciones Multicontenedor:** Al usar la configuración de base de datos (`IS_CONFIG_VARIABLES_IN_DB_ENABLED=true`), tanto los contenedores del servidor como los de trabajo leen de la misma base de datos. Los cambios en el panel de administración afectan a ambos automáticamente, eliminando la necesidad de duplicar las variables de entorno entre contenedores (excepto para las variables de infraestructura). **Qué se puede configurar a través del panel de administración:** * **Autenticación** - OAuth de Google/Microsoft, configuración de contraseñas * **Correo Electrónico** - Configuración de SMTP, plantillas, verificación * **Almacenamiento** - Configuración S3, rutas de almacenamiento local * **Integraciones** - Gmail, Google Calendar, servicios de Microsoft * **Flujo de Trabajo y Limitación de Tasas** - Límites de ejecución, restricción de API * **Y mucho más...** ![Variables de Configuración del Panel de Administración](/images/user-guide/setup/admin-panel-config-variables.png) Cada variable está documentada con descripciones en su panel de administración en **Configuración → Panel de Administración → Variables de Configuración**. Algunas configuraciones de infraestructura como las conexiones de base de datos (`PG_DATABASE_URL`), URLs del servidor (`SERVER_URL`), y secretos de la aplicación (`APP_SECRET`) solo se pueden configurar a través del archivo `.env`. [Referencia técnica completa →](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts) ## 2. Configuración Solo de Entorno ```bash IS_CONFIG_VARIABLES_IN_DB_ENABLED=false ``` **Toda la configuración se gestiona a través de archivos `.env`:** 1. Establezca `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false` en su archivo `.env` 2. Agregue todas las variables de configuración a su archivo `.env` 3. Reinicie los contenedores para que los cambios tengan efecto 4. El panel de administración mostrará los valores actuales pero no podrá modificarlos ## Multi-Workspace Mode By default, Twenty runs in **single-workspace mode** — ideal for most self-hosted deployments where you need one CRM instance for your organization. ### Single-Workspace Mode (Default) ```bash IS_MULTIWORKSPACE_ENABLED=false # default ``` * One workspace per Twenty instance * First user automatically becomes admin with full privileges (`canImpersonate` and `canAccessFullAdminPanel`) * New signups are disabled after the first workspace is created * Simple URL structure: `https://your-domain.com` ### Enabling Multi-Workspace Mode ```bash IS_MULTIWORKSPACE_ENABLED=true DEFAULT_SUBDOMAIN=app # default value ``` Enable multi-workspace mode for SaaS-like deployments where multiple independent teams need their own workspaces on the same Twenty instance. **Key differences from single-workspace mode:** * Multiple workspaces can be created on the same instance * Each workspace gets its own subdomain (e.g., `sales.your-domain.com`, `marketing.your-domain.com`) * Users sign up and log in at `{DEFAULT_SUBDOMAIN}.your-domain.com` (e.g., `app.your-domain.com`) * No automatic admin privileges — first user in each workspace is a regular user * Workspace-specific settings like subdomain and custom domain become available in workspace settings **Environment-only setting:** `IS_MULTIWORKSPACE_ENABLED` can only be configured via `.env` file and requires a restart. It cannot be changed through the admin panel. ### DNS Configuration for Multi-Workspace When using multi-workspace mode, configure your DNS with a wildcard record to allow dynamic subdomain creation: ``` *.your-domain.com -> your-server-ip ``` This enables automatic subdomain routing for new workspaces without manual DNS configuration. ### Restricting Workspace Creation In multi-workspace mode, you may want to limit who can create new workspaces: ```bash IS_WORKSPACE_CREATION_LIMITED_TO_SERVER_ADMINS=true ``` When enabled, only users with `canAccessFullAdminPanel` can create additional workspaces. Users can still create their first workspace during initial signup. ## Integración con Gmail y Google Calendar ### Crear Proyecto en Google Cloud 1. Vaya a [Google Cloud Console](https://console.cloud.google.com/) 2. Cree un nuevo proyecto o seleccione uno existente 3. Habilite estas APIs: * [Gmail API](https://console.cloud.google.com/apis/library/gmail.googleapis.com) * [Google Calendar API](https://console.cloud.google.com/apis/library/calendar-json.googleapis.com) * [People API](https://console.cloud.google.com/apis/library/people.googleapis.com) ### Configurar OAuth 1. Vaya a [Credenciales](https://console.cloud.google.com/apis/credentials) 2. Cree un ID de Cliente OAuth 2.0 3. Agregue estas URIs de redirección: * `https://{your-domain}/auth/google/redirect` (for SSO) * `https://{your-domain}/auth/google-apis/get-access-token` (for integrations) ### Configurar en Twenty 1. Vaya a **Configuración → Panel de Administración → Variables de Configuración** 2. Encuentre la sección **Google Auth** 3. Establezca estas variables: * `MESSAGING_PROVIDER_GMAIL_ENABLED=true` * `CALENDAR_PROVIDER_GOOGLE_ENABLED=true` * `AUTH_GOOGLE_CLIENT_ID={client-id}` * `AUTH_GOOGLE_CLIENT_SECRET={client-secret}` * `AUTH_GOOGLE_CALLBACK_URL=https://{your-domain}/auth/google/redirect` * `AUTH_GOOGLE_APIS_CALLBACK_URL=https://{your-domain}/auth/google-apis/get-access-token` **Modo solo de entorno:** Si establece `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, agregue estas variables a su archivo `.env` en su lugar. **Ámbitos requeridos** (configurados automáticamente): [Ver código fuente relevante](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/auth/utils/get-google-apis-oauth-scopes.ts#L4-L10) * `https://www.googleapis.com/auth/calendar.events` * `https://www.googleapis.com/auth/gmail.readonly` * `https://www.googleapis.com/auth/profile.emails.read` ### Si su aplicación está en modo de prueba Si su aplicación está en modo de prueba, deberá agregar usuarios de prueba a su proyecto. En [Pantalla de consentimiento OAuth](https://console.cloud.google.com/apis/credentials/consent), agregue sus usuarios de prueba en la sección "Usuarios de prueba". ## Integración con Microsoft 365 Los usuarios deben tener una [licencia de Microsoft 365](https://admin.microsoft.com/Adminportal/Home) para poder usar la API de Calendar y Messaging. No podrán sincronizar su cuenta en Twenty sin una. ### Cree un proyecto en Microsoft Azure Necesitará crear un proyecto en [Microsoft Azure](https://portal.azure.com/#view/Microsoft_AAD_IAM/AppGalleryBladeV2) y obtener las credenciales. ### Habilitar APIs En la Consola de Microsoft Azure habilite las siguientes APIs en "Permisos": * Microsoft Graph: Mail.ReadWrite * Microsoft Graph: Mail.Send * Microsoft Graph: Calendars.Read * Microsoft Graph: User.Read * Microsoft Graph: openid * Microsoft Graph: email * Microsoft Graph: profile * Microsoft Graph: offline_access Nota: "Mail.ReadWrite" y "Mail.Send" solo son obligatorios si desea enviar correos electrónicos usando nuestras acciones de flujo de trabajo. Puede usar "Mail.Read" en su lugar si solo desea recibir correos electrónicos. ### URIs de redirección autorizadas Necesita agregar las siguientes URIs de redirección a su proyecto: * `https://{your-domain}/auth/microsoft/redirect` if you want to use Microsoft SSO * `https://{your-domain}/auth/microsoft-apis/get-access-token` ### Configurar en Twenty 1. Vaya a **Configuración → Panel de Administración → Variables de Configuración** 2. Encuentre la sección **Microsoft Auth** 3. Establezca estas variables: * `MESSAGING_PROVIDER_MICROSOFT_ENABLED=true` * `CALENDAR_PROVIDER_MICROSOFT_ENABLED=true` * `AUTH_MICROSOFT_ENABLED=true` * `AUTH_MICROSOFT_CLIENT_ID={client-id}` * `AUTH_MICROSOFT_CLIENT_SECRET={client-secret}` * `AUTH_MICROSOFT_CALLBACK_URL=https://{your-domain}/auth/microsoft/redirect` * `AUTH_MICROSOFT_APIS_CALLBACK_URL=https://{your-domain}/auth/microsoft-apis/get-access-token` **Modo solo de entorno:** Si establece `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, agregue estas variables a su archivo `.env` en su lugar. ### Configurar ámbitos [Ver código fuente relevante](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/auth/utils/get-microsoft-apis-oauth-scopes.ts#L2-L9) * 'openid' * 'correo Electrónico' * 'perfil' * 'offline_access' * 'Mail.ReadWrite' * 'Mail.Send' * 'Calendars.Read' ### Si su aplicación está en modo de prueba Si su aplicación está en modo de prueba, deberá agregar usuarios de prueba a su proyecto. Agregue sus usuarios de prueba a la sección "Usuarios y grupos". ## Trabajos en segundo plano para Calendarios y Mensajes Después de configurar las integraciones de Gmail, Google Calendar, o Microsoft 365, necesita iniciar los trabajos en segundo plano que sincronizan los datos. Registre los siguientes trabajos recurrentes en su contenedor de trabajo: ```bash # desde su contenedor de trabajo yarn command:prod cron:messaging:messages-import yarn command:prod cron:messaging:message-list-fetch yarn command:prod cron:calendar:calendar-event-list-fetch yarn command:prod cron:calendar:calendar-events-import yarn command:prod cron:messaging:ongoing-stale yarn command:prod cron:calendar:ongoing-stale yarn command:prod cron:workflow:automated-cron-trigger ``` ## Configuración de Correo Electrónico 1. Vaya a **Configuración → Panel de Administración → Variables de Configuración** 2. Encuentre la sección **Correo Electrónico** 3. Configure su configuración SMTP: Necesitará proporcionar una [Contraseña de Aplicación](https://support.google.com/accounts/answer/185833). * EMAIL_DRIVER=smtp * EMAIL_SMTP_HOST=smtp.gmail.com * EMAIL_SMTP_PORT=465 * EMAIL_SMTP_USER=gmail_email_address * EMAIL_SMTP_PASSWORD='gmail_app_password' Tenga en cuenta que si tiene la autenticación de dos factores habilitada, necesitará proporcionar una [Contraseña de Aplicación](https://support.microsoft.com/en-us/account-billing/manage-app-passwords-for-two-step-verification-d6dc8c6d-4bf7-4851-ad95-6d07799387e9). * EMAIL_DRIVER=smtp * EMAIL_SMTP_HOST=smtp.office365.com * EMAIL_SMTP_PORT=587 * EMAIL_SMTP_USER=office365_email_address * EMAIL_SMTP_PASSWORD='office365_password' **smtp4dev** es un servidor de correo SMTP falso para desarrollo y pruebas. * Ejecute la imagen de smtp4dev: `docker run --rm -it -p 8090:80 -p 2525:25 rnwood/smtp4dev` * Acceda a la interfaz de smtp4dev aquí: [http://localhost:8090](http://localhost:8090) * Establezca las siguientes variables: * EMAIL_DRIVER=smtp * EMAIL_SMTP_HOST=localhost * EMAIL_SMTP_PORT=2525 **Modo solo de entorno:** Si establece `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, agregue estas variables a su archivo `.env` en su lugar.