houseassassin/twenty
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

i18n - docs translations (#17433)

Browse Source 
Created by Github action

Co-authored-by: github-actions <github-actions@twenty.com>
This commit is contained in:
github-actions[bot]
2026-01-26 07:11:01 +01:00
committed by GitHub
parent c8c821a692
commit 2353bc62cc
361 changed files with 20096 additions and 17317 deletions
Download Patch File Download Diff File Expand all files Collapse all files
packages/twenty-docs/l/es/developers/self-host/capabilities/cloud-providers.mdx
+18 -18
View File
@@ -1,45 +1,45 @@
---
title: Other methods
title: Otros métodos
---
<Warning>
This document is maintained by the community. It might contain issues.
Este documento es mantenido por la comunidad. Podría contener problemas.
</Warning>
## Kubernetes via Terraform and Manifests
## Kubernetes vía Terraform y Manifests
Community-led documentation for Kubernetes deployment is available [here](https://github.com/twentyhq/twenty/tree/main/packages/twenty-docker/k8s)
Documentación comunitaria para la implementación de Kubernetes está disponible [aquí](https://github.com/twentyhq/twenty/tree/main/packages/twenty-docker/k8s)
### Coolify
Deploy Twenty on servers using Coolify. (official image on Coolify will be available soon)
Despliega Twenty en servidores usando Coolify. (la imagen oficial en Coolify estará disponible pronto)
[Coolify documentation](https://coolify.io/docs/get-started/introduction)
[Documentación de Coolify](https://coolify.io/docs/get-started/introduction)
### EasyPanel
Deploy Twenty on EasyPanel with the community maintained template below.
Despliega Twenty en EasyPanel con la plantilla mantenida por la comunidad a continuación.
[Deploy on EasyPanel](https://easypanel.io/docs/templates/twenty)
[Desplegar en EasyPanel](https://easypanel.io/docs/templates/twenty)
### Elest.io
Deploy Twenty on servers with Elest.io using link below.
Despliega Twenty en servidores con Elest.io utilizando el enlace a continuación.
[Deploy on Elest.io](https://elest.io/open-source/twenty)
[Desplegar en Elest.io](https://elest.io/open-source/twenty)
### Twenty on Railway
### Twenty en Railway
Deploy Twenty on Railway with the community maintained template below.
Despliega Twenty en Railway con la plantilla mantenida por la comunidad a continuación.
[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/nAL3hA)
[![Desplegar en Railway](https://railway.com/button.svg)](https://railway.com/deploy/nAL3hA)
### Twenty on Sealos
### Twenty en Sealos
Deploy Twenty on Sealos with the community maintained template below.
Despliega Twenty en Sealos con la plantilla mantenida por la comunidad a continuación.
[![Deploy on Sealos](https://sealos.io/Deploy-on-Sealos.svg)](https://sealos.io/products/app-store/twenty)
[![Desplegar en Sealos](https://sealos.io/Deploy-on-Sealos.svg)](https://sealos.io/products/app-store/twenty)
## Others
## Otros
Please feel free to Open a PR to add more Cloud Provider options.
No dudes en abrir un PR para añadir más opciones de proveedores de la nube.
packages/twenty-docs/l/es/developers/self-host/capabilities/docker-compose.mdx
+89 -89
View File
@@ -1,253 +1,253 @@
---
title: 1-Click w/ Docker Compose
title: 1-Clic con Docker Compose
---
<Warning>
Docker containers are for production hosting or self-hosting, for the contribution please check the [Local Setup](/l/es/developers/contribute/capabilities/local-setup).
Los contenedores de Docker son para alojamiento en producción o autoalojamiento, para la contribución por favor revise la [Configuración Local](/l/es/developers/contribute/capabilities/local-setup).
</Warning>
## Overview
## Resumen
This guide provides step-by-step instructions to install and configure the Twenty application using Docker Compose. The aim is to make the process straightforward and prevent common pitfalls that could break your setup.
Esta guía proporciona instrucciones paso a paso para instalar y configurar la aplicación Twenty utilizando Docker Compose. El objetivo es simplificar el proceso y prevenir errores comunes que podrían arruinar tu configuración.
**Important:** Only modify settings explicitly mentioned in this guide. Altering other configurations may lead to issues.
**Importante:** Solo modifica configuraciones explícitamente mencionadas en esta guía. Alterar otras configuraciones puede causar problemas.
See docs [Setup Environment Variables](/l/es/developers/self-host/capabilities/setup) for advanced configuration. All environment variables must be declared in the docker-compose.yml file at the server and / or worker level depending on the variable.
Consulta los documentos [Configurar Variables de Entorno](/l/es/developers/self-host/capabilities/setup) para configuraciones avanzadas. Todas las variables de entorno deben ser declaradas en el archivo docker-compose.yml en el nivel del servidor y/o trabajador dependiendo de la variable.
## System Requirements
## Requisitos del sistema
* RAM: Ensure your environment has at least 2GB of RAM. Insufficient memory can cause processes to crash.
* Docker & Docker Compose: Make sure both are installed and up-to-date.
* RAM: Asegúrate de que tu entorno tenga al menos 2GB de RAM. La memoria insuficiente puede causar que los procesos se bloqueen.
* Docker & Docker Compose: Asegúrate de que ambos estén instalados y actualizados.
## Option 1: One-line script
## Opción 1: Script de una línea
Install the latest stable version of Twenty with a single command:
Instala la última versión estable de Twenty con un solo comando:
```bash
bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)
```
To install a specific version or branch:
Para instalar una versión o rama específica:
```bash
VERSION=vx.y.z BRANCH=branch-name bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)
```
* Replace x.y.z with the desired version number.
* Replace branch-name with the name of the branch you want to install.
* Reemplace x.y.z con el número de versión deseado.
* Reemplace branch-name con el nombre de la rama que desea instalar.
## Option 2: Manual steps
## Opción 2: Pasos manuales
Follow these steps for a manual setup.
Sigue estos pasos para una configuración manual.
### Step 1: Set Up the Environment File
### Paso 1: Configurar el archivo de entorno
1. **Create the .env File**
1. **Crea el archivo .env**
Copy the example environment file to a new .env file in your working directory:
Copia el archivo de entorno de ejemplo a tu directorio de trabajo a un nuevo archivo .env:
```bash
curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/.env.example
```
2. **Generate Secret Tokens**
2. **Generar tokens secretos**
Run the following command to generate a unique random string:
Ejecuta el siguiente comando para generar una cadena única aleatoria:
```bash
openssl rand -base64 32
```
**Important:** Keep this value secret / do not share it.
**Importante:** Mantén este valor en secreto / no lo compartas.
3. **Update the `.env`**
3. **Actualiza el `.env`**
Replace the placeholder value in your .env file with the generated token:
Reemplaza el valor de marcador de posición en tu archivo .env con el token generado:
```ini
APP_SECRET=first_random_string
```
4. **Set the Postgres Password**
4. **Establecer la contraseña de Postgres**
Update the `PG_DATABASE_PASSWORD` value in the .env file with a strong password without special characters.
Actualiza el valor de `PG_DATABASE_PASSWORD` en el archivo .env con una contraseña fuerte sin caracteres especiales.
```ini
PG_DATABASE_PASSWORD=my_strong_password
```
### Step 2: Obtain the Docker Compose File
### Paso 2: Obtener el archivo Docker Compose
Download the `docker-compose.yml` file to your working directory:
Descarga el archivo `docker-compose.yml` en tu directorio de trabajo:
```bash
curl -o docker-compose.yml https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/docker-compose.yml
```
### Step 3: Launch the Application
### Paso 3: Lanza la aplicación
Start the Docker containers:
Inicia los contenedores Docker:
```bash
docker compose up -d
```
### Step 4: Access the Application
### Paso 4: Acceder a la aplicación
If you host twentyCRM on your own computer, open your browser and navigate to [http://localhost:3000](http://localhost:3000).
Si alojas twentyCRM en tu propia computadora, abre tu navegador y navega a [http://localhost:3000](http://localhost:3000).
If you host it on a server, check that the server is running and that everything is ok with
Si lo alojas en un servidor, verifica que el servidor esté en funcionamiento y que todo esté bien con
```bash
curl http://localhost:3000
```
## Configuration
## Configuración
### Expose Twenty to External Access
### Exponer Twenty para acceso externo
By default, Twenty runs on `localhost` at port `3000`. To access it via an external domain or IP address, you need to configure the `SERVER_URL` in your `.env` file.
Por defecto, Twenty se ejecuta en `localhost` en el puerto `3000`. Para acceder a él mediante un dominio externo o dirección IP, necesitas configurar `SERVER_URL` en tu archivo `.env`.
#### Understanding `SERVER_URL`
#### Entendiendo `SERVER_URL`
* **Protocol:** Use `http` or `https` depending on your setup.
* Use `http` if you haven't set up SSL.
* Use `https` if you have SSL configured.
* **Domain/IP:** This is the domain name or IP address where your application is accessible.
* **Port:** Include the port number if you're not using the default ports (`80` for `http`, `443` for `https`).
* **Protocolo:** Usa `http` o `https` dependiendo de tu configuración.
* Usa `http` si no has configurado SSL.
* Usa `https` si tienes SSL configurado.
* **Dominio/IP:** Este es el nombre de dominio o dirección IP donde tu aplicación es accesible.
* **Puerto:** Incluye el número de puerto si no estás usando los puertos predeterminados (`80` para `http`, `443` para `https`).
### SSL Requirements
### Requisitos de SSL
SSL (HTTPS) is required for certain browser features to work properly. While these features might work during local development (as browsers treat localhost differently), a proper SSL setup is needed when hosting Twenty on a regular domain.
SSL (HTTPS) es requerido para que ciertas características del navegador funcionen correctamente. Aunque estas características podrían funcionar durante el desarrollo local (ya que los navegadores tratan localhost de manera diferente), se requiere una configuración SSL adecuada al alojar Twenty en un dominio regular.
For example, the clipboard API might require a secure context - some features like copy buttons throughout the application might not work without HTTPS enabled.
Por ejemplo, es posible que la API del portapapeles requiera un contexto seguro: algunas características como los botones de copia en toda la aplicación pueden no funcionar sin HTTPS habilitado.
We strongly recommend setting up Twenty behind a reverse proxy with SSL termination for optimal security and functionality.
Recomendamos encarecidamente configurar Twenty detrás de un proxy inverso con terminación SSL para una seguridad y funcionalidad óptimas.
#### Configuring `SERVER_URL`
#### Configurando `SERVER_URL`
1. **Determine Your Access URL**
* **Without Reverse Proxy (Direct Access):**
1. **Determine su URL de acceso**
* **Sin proxy inverso (Acceso directo):**
If you're accessing the application directly without a reverse proxy:
Si estás accediendo a la aplicación directamente sin un proxy inverso:
```ini
SERVER_URL=http://your-domain-or-ip:3000
```
* **With Reverse Proxy (Standard Ports):**
* **Con proxy inverso (Puertos estándar):**
If you're using a reverse proxy like Nginx or Traefik and have SSL configured:
Si estás usando un proxy inverso como Nginx o Traefik y tienes SSL configurado:
```ini
SERVER_URL=https://your-domain-or-ip
```
* **With Reverse Proxy (Custom Ports):**
* **Con proxy inverso (Puertos personalizados):**
If you're using non-standard ports:
Si estás usando puertos no estándar:
```ini
SERVER_URL=https://your-domain-or-ip:custom-port
```
2. **Update the `.env` File**
2. **Actualiza el archivo `.env`**
Open your `.env` file and update the `SERVER_URL`:
Abre tu archivo `.env` y actualiza el `SERVER_URL`:
```ini
SERVER_URL=http(s)://your-domain-or-ip:your-port
```
**Examples:**
**Ejemplos:**
* Direct access without SSL:
* Acceso directo sin SSL:
```ini
SERVER_URL=http://123.45.67.89:3000
```
* Access via domain with SSL:
* Acceso vía dominio con SSL:
```ini
SERVER_URL=https://mytwentyapp.com
```
3. **Restart the Application**
3. **Reiniciar la aplicación**
For changes to take effect, restart the Docker containers:
Para que los cambios surtan efecto, reinicia los contenedores Docker:
```bash
docker compose down
docker compose up -d
```
#### Considerations
#### Consideraciones
* **Reverse Proxy Configuration:**
* **Configuración del Proxy Inverso:**
Ensure your reverse proxy forwards requests to the correct internal port (`3000` by default). Configure SSL termination and any necessary headers.
Asegúrese de que su proxy inverso envíe las solicitudes al puerto interno correcto (`3000` por defecto). Configure la terminación SSL y cualquier cabecera necesaria.
* **Firewall Settings:**
* **Configuración del Cortafuegos:**
Open necessary ports in your firewall to allow external access.
Abra los puertos necesarios en su cortafuegos para permitir el acceso externo.
* **Consistency:**
* **Consistencia:**
The `SERVER_URL` must match how users access your application in their browsers.
La `SERVER_URL` debe coincidir con cómo los usuarios acceden a su aplicación en sus navegadores.
#### Persistence
#### Persistencia
* **Data Volumes:**
* **Volúmenes de Datos:**
The Docker Compose configuration uses volumes to persist data for the database and server storage.
La configuración de Docker Compose utiliza volúmenes para persistir datos para la base de datos y el almacenamiento del servidor.
* **Stateless Environments:**
* **Entornos Sin Estado:**
If deploying to a stateless environment (e.g., certain cloud services), configure external storage to persist data.
Si se despliega en un entorno sin estado (por ejemplo, ciertos servicios en la nube), configure un almacenamiento externo para persistir los datos.
## Backup and Restore
## Copia de seguridad y restauración
Regular backups protect your CRM data from loss.
Las copias de seguridad periódicas protegen los datos de tu CRM contra la pérdida.
### Create a Database Backup
### Crea una copia de seguridad de la base de datos
```bash
docker exec twenty-postgres pg_dump -U postgres twenty > backup_$(date +%Y%m%d).sql
```
### Automate Daily Backups
### Automatiza las copias de seguridad diarias
Add to your crontab (`crontab -e`):
Añade a tu crontab (`crontab -e`):
```bash
0 2 * * * docker exec twenty-postgres pg_dump -U postgres twenty > /backups/twenty_$(date +\%Y\%m\%d).sql
```
### Restore from Backup
### Restaura desde una copia de seguridad
1. Stop the application:
1. Detén la aplicación:
```bash
docker compose stop twenty-server twenty-front
```
2. Restore the database:
2. Restaura la base de datos:
```bash
docker exec -i twenty-postgres psql -U postgres twenty < backup_20240115.sql
```
3. Restart services:
3. Reinicia los servicios:
```bash
docker compose up -d
```
### Backup Best Practices
### Mejores prácticas de copias de seguridad
* **Test restores regularly** — verify backups actually work
* **Store backups off-site** — use cloud storage (S3, GCS, etc.)
* **Encrypt sensitive data** — protect backups with encryption
* **Retain multiple copies** — keep daily, weekly, and monthly backups
* **Prueba las restauraciones con regularidad** — verifica que las copias de seguridad realmente funcionen
* **Almacena las copias de seguridad fuera del sitio** — usa almacenamiento en la nube (S3, GCS, etc.)
* **Cifra los datos sensibles** — protege las copias de seguridad con cifrado
* **Conserva múltiples copias** — mantén copias de seguridad diarias, semanales y mensuales
## Troubleshooting
## Solución de Problemas
If you encounter any problem, check [Troubleshooting](/l/es/developers/self-host/capabilities/troubleshooting) for solutions.
Si encuentras algún problema, consulta [Solución de Problemas](/l/es/developers/self-host/capabilities/troubleshooting) para ver soluciones.
packages/twenty-docs/l/es/developers/self-host/capabilities/setup.mdx
+152 -108
View File
@@ -1,146 +1,146 @@
---
title: Setup
title: Configuración
---
# Configuration Management
# Gestión de Configuración
<Warning>
**First time installing?** Follow the [Docker Compose installation guide](/l/es/developers/self-host/capabilities/docker-compose) to get Twenty running, then return here for configuration.
**¿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.
</Warning>
Twenty offers **two configuration modes** to suit different deployment needs:
Twenty ofrece **dos modos de configuración** para adaptarse a diferentes necesidades de implementación:
**Admin panel access:** Only users with admin privileges (`canAccessFullAdminPanel: true`) can access the configuration interface.
**Acceso al panel de administración:** Solo los usuarios con privilegios de administrador (`canAccessFullAdminPanel: true`) pueden acceder a la interfaz de configuración.
## 1. Admin Panel Configuration (Default)
## 1. Configuración del Panel de Administración (Predeterminado)
```bash
IS_CONFIG_VARIABLES_IN_DB_ENABLED=true # default
```
**Most configuration happens through the UI** after installation:
**La mayoría de las configuraciones se realizan a través de la interfaz** después de la instalación:
1. Access your Twenty instance (usually `http://localhost:3000`)
2. Go to **Settings / Admin Panel / Configuration Variables**
3. Configure integrations, email, storage, and more
4. Changes take effect immediately (within 15 seconds for multi-container deployments)
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)
<Warning>
**Multi-Container Deployments:** When using database configuration (`IS_CONFIG_VARIABLES_IN_DB_ENABLED=true`), both server and worker containers read from the same database. Admin panel changes affect both automatically, eliminating the need to duplicate environment variables between containers (except for infrastructure variables).
**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).
</Warning>
**What you can configure through the admin panel:**
**Qué se puede configurar a través del panel de administración:**
* **Authentication** - Google/Microsoft OAuth, password settings
* **Email** - SMTP settings, templates, verification
* **Storage** - S3 configuration, local storage paths
* **Integrations** - Gmail, Google Calendar, Microsoft services
* **Workflow & Rate Limiting** - Execution limits, API throttling
* **And much more...**
* **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...**
![Admin Panel Configuration Variables](/images/user-guide/setup/admin-panel-config-variables.png)
![Variables de Configuración del Panel de Administración](/images/user-guide/setup/admin-panel-config-variables.png)
<Warning>
Each variable is documented with descriptions in your admin panel at **Settings → Admin Panel → Configuration Variables**.
Some infrastructure settings like database connections (`PG_DATABASE_URL`), server URLs (`SERVER_URL`), and app secrets (`APP_SECRET`) can only be configured via `.env` file.
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`.
[Complete technical reference →](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts)
[Referencia técnica completa →](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts)
</Warning>
## 2. Environment-Only Configuration
## 2. Configuración Solo de Entorno
```bash
IS_CONFIG_VARIABLES_IN_DB_ENABLED=false
```
**All configuration managed through `.env` files:**
**Toda la configuración se gestiona a través de archivos `.env`:**
1. Set `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false` in your `.env` file
2. Add all configuration variables to your `.env` file
3. Restart containers for changes to take effect
4. Admin panel will show current values but cannot modify them
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
## Modo de múltiples espacios de trabajo
By default, Twenty runs in **single-workspace mode** — ideal for most self-hosted deployments where you need one CRM instance for your organization.
De forma predeterminada, Twenty se ejecuta en **modo de un solo espacio de trabajo** — ideal para la mayoría de las implementaciones autoalojadas en las que necesitas una instancia de CRM para tu organización.
### Single-Workspace Mode (Default)
### Modo de un solo espacio de trabajo (predeterminado)
```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`
* Un espacio de trabajo por instancia de Twenty
* El primer usuario se convierte automáticamente en administrador con privilegios completos (`canImpersonate` y `canAccessFullAdminPanel`)
* Los nuevos registros se deshabilitan después de crear el primer espacio de trabajo
* Estructura de URL simple: `https://your-domain.com`
### Enabling Multi-Workspace Mode
### Habilitar el modo de múltiples espacios de trabajo
```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.
Habilita el modo de múltiples espacios de trabajo para implementaciones tipo SaaS en las que varios equipos independientes necesitan sus propios espacios de trabajo en la misma instancia de Twenty.
**Key differences from single-workspace mode:**
**Diferencias clave respecto al modo de un solo espacio de trabajo:**
* 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
* Se pueden crear varios espacios de trabajo en la misma instancia
* Cada espacio de trabajo obtiene su propio subdominio (p. ej., `sales.your-domain.com`, `marketing.your-domain.com`)
* Los usuarios se registran e inician sesión en `{DEFAULT_SUBDOMAIN}.your-domain.com` (p. ej., `app.your-domain.com`)
* Sin privilegios de administrador automáticos — el primer usuario de cada espacio de trabajo es un usuario normal
* Configuraciones específicas del espacio de trabajo, como subdominio y dominio personalizado, están disponibles en la configuración del espacio de trabajo
<Warning>
**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.
**Configuración solo por entorno:** `IS_MULTIWORKSPACE_ENABLED` solo se puede configurar mediante el archivo `.env` y requiere un reinicio. No se puede cambiar a través del panel de administración.
</Warning>
### DNS Configuration for Multi-Workspace
### Configuración de DNS para múltiples espacios de trabajo
When using multi-workspace mode, configure your DNS with a wildcard record to allow dynamic subdomain creation:
Al usar el modo de múltiples espacios de trabajo, configura tu DNS con un registro comodín para permitir la creación dinámica de subdominios:
```
*.your-domain.com -> your-server-ip
```
This enables automatic subdomain routing for new workspaces without manual DNS configuration.
Esto habilita el enrutamiento automático de subdominios para nuevos espacios de trabajo sin configuración manual de DNS.
### Restricting Workspace Creation
### Restricción de la creación de espacios de trabajo
In multi-workspace mode, you may want to limit who can create new workspaces:
En el modo de múltiples espacios de trabajo, es posible que quieras limitar quién puede crear nuevos espacios de trabajo:
```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.
Cuando está habilitado, solo los usuarios con `canAccessFullAdminPanel` pueden crear espacios de trabajo adicionales. Los usuarios aún pueden crear su primer espacio de trabajo durante el registro inicial.
## Gmail & Google Calendar Integration
## Integración con Gmail y Google Calendar
### Create Google Cloud Project
### Crear Proyecto en Google Cloud
1. Go to [Google Cloud Console](https://console.cloud.google.com/)
2. Create a new project or select existing one
3. Enable these APIs:
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)
### Configure OAuth
### Configurar OAuth
1. Go to [Credentials](https://console.cloud.google.com/apis/credentials)
2. Create OAuth 2.0 Client ID
3. Add these redirect URIs:
* `https://{your-domain}/auth/google/redirect` (for SSO)
* `https://{your-domain}/auth/google-apis/get-access-token` (for integrations)
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` (para SSO)
* `https://{your-domain}/auth/google-apis/get-access-token` (para integraciones)
### Configure in Twenty
### Configurar en Twenty
1. Go to **Settings → Admin Panel → Configuration Variables**
2. Find the **Google Auth** section
3. Set these variables:
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}`
@@ -149,35 +149,35 @@ When enabled, only users with `canAccessFullAdminPanel` can create additional wo
* `AUTH_GOOGLE_APIS_CALLBACK_URL=https://{your-domain}/auth/google-apis/get-access-token`
<Warning>
**Environment-only mode:** If you set `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, add these variables to your `.env` file instead.
**Modo solo de entorno:** Si establece `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, agregue estas variables a su archivo `.env` en su lugar.
</Warning>
**Required scopes** (automatically configured):
[See relevant source code](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/auth/utils/get-google-apis-oauth-scopes.ts#L4-L10)
**Á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`
### If your app is in test mode
### Si su aplicación está en modo de prueba
If your app is in test mode, you will need to add test users to your project.
Si su aplicación está en modo de prueba, deberá agregar usuarios de prueba a su proyecto.
Under [OAuth consent screen](https://console.cloud.google.com/apis/credentials/consent), add your test users to the "Test users" section.
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".
## Microsoft 365 Integration
## Integración con Microsoft 365
<Warning>
Users must have a [Microsoft 365 Licence](https://admin.microsoft.com/Adminportal/Home) to be able to use the Calendar and Messaging API. They will not be able to sync their account on Twenty without one.
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.
</Warning>
### Create a project in Microsoft Azure
### Cree un proyecto en Microsoft Azure
You will need to create a project in [Microsoft Azure](https://portal.azure.com/#view/Microsoft_AAD_IAM/AppGalleryBladeV2) and get the credentials.
Necesitará crear un proyecto en [Microsoft Azure](https://portal.azure.com/#view/Microsoft_AAD_IAM/AppGalleryBladeV2) y obtener las credenciales.
### Enable APIs
### Habilitar APIs
On Microsoft Azure Console enable the following APIs in "Permissions":
En la Consola de Microsoft Azure habilite las siguientes APIs en "Permisos":
* Microsoft Graph: Mail.ReadWrite
* Microsoft Graph: Mail.Send
@@ -188,20 +188,20 @@ On Microsoft Azure Console enable the following APIs in "Permissions":
* Microsoft Graph: profile
* Microsoft Graph: offline_access
Note: "Mail.ReadWrite" and "Mail.Send" are only mandatory if you want to send emails using our workflow actions. You can use "Mail.Read" instead if you only want to receive emails.
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.
### Authorized redirect URIs
### URIs de redirección autorizadas
You need to add the following redirect URIs to your project:
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/redirect` si quieres usar el inicio de sesión único de Microsoft
* `https://{your-domain}/auth/microsoft-apis/get-access-token`
### Configure in Twenty
### Configurar en Twenty
1. Go to **Settings → Admin Panel → Configuration Variables**
2. Find the **Microsoft Auth** section
3. Set these variables:
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`
@@ -211,32 +211,32 @@ You need to add the following redirect URIs to your project:
* `AUTH_MICROSOFT_APIS_CALLBACK_URL=https://{your-domain}/auth/microsoft-apis/get-access-token`
<Warning>
**Environment-only mode:** If you set `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, add these variables to your `.env` file instead.
**Modo solo de entorno:** Si establece `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, agregue estas variables a su archivo `.env` en su lugar.
</Warning>
### Configure scopes
### Configurar ámbitos
[See relevant source code](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/auth/utils/get-microsoft-apis-oauth-scopes.ts#L2-L9)
[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'
* 'email'
* 'profile'
* 'correo Electrónico'
* 'perfil'
* 'offline_access'
* 'Mail.ReadWrite'
* 'Mail.Send'
* 'Calendars.Read'
### If your app is in test mode
### Si su aplicación está en modo de prueba
If your app is in test mode, you will need to add test users to your project.
Si su aplicación está en modo de prueba, deberá agregar usuarios de prueba a su proyecto.
Add your test users to the "Users and groups" section.
Agregue sus usuarios de prueba a la sección "Usuarios y grupos".
## Background Jobs for Calendar & Messaging
## Trabajos en segundo plano para Calendarios y Mensajes
After configuring Gmail, Google Calendar, or Microsoft 365 integrations, you need to start the background jobs that sync data.
Después de configurar las integraciones de Gmail, Google Calendar, o Microsoft 365, necesita iniciar los trabajos en segundo plano que sincronizan los datos.
Register the following recurring jobs in your worker container:
Registre los siguientes trabajos recurrentes en su contenedor de trabajo:
```bash
# from your worker container
@@ -249,15 +249,15 @@ yarn command:prod cron:calendar:ongoing-stale
yarn command:prod cron:workflow:automated-cron-trigger
```
## Email Configuration
## Configuración de Correo Electrónico
1. Go to **Settings → Admin Panel → Configuration Variables**
2. Find the **Email** section
3. Configure your SMTP settings:
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:
<ArticleTabs label1="Gmail" label2="Office365" label3="Smtp4dev">
<ArticleTab>
You will need to provision an [App Password](https://support.google.com/accounts/answer/185833).
Necesitará proporcionar una [Contraseña de Aplicación](https://support.google.com/accounts/answer/185833).
* EMAIL_DRIVER=smtp
* EMAIL_SMTP_HOST=smtp.gmail.com
@@ -267,7 +267,7 @@ yarn command:prod cron:workflow:automated-cron-trigger
</ArticleTab>
<ArticleTab>
Keep in mind that if you have 2FA enabled, you will need to provision an [App Password](https://support.microsoft.com/en-us/account-billing/manage-app-passwords-for-two-step-verification-d6dc8c6d-4bf7-4851-ad95-6d07799387e9).
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
@@ -277,11 +277,11 @@ yarn command:prod cron:workflow:automated-cron-trigger
</ArticleTab>
<ArticleTab>
**smtp4dev** is a fake SMTP email server for development and testing.
**smtp4dev** es un servidor de correo SMTP falso para desarrollo y pruebas.
* Run the smtp4dev image: `docker run --rm -it -p 8090:80 -p 2525:25 rnwood/smtp4dev`
* Access the smtp4dev ui here: [http://localhost:8090](http://localhost:8090)
* Set the following variables:
* 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
@@ -289,5 +289,49 @@ yarn command:prod cron:workflow:automated-cron-trigger
</ArticleTabs>
<Warning>
**Environment-only mode:** If you set `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, add these variables to your `.env` file instead.
**Modo solo de entorno:** Si establece `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, agregue estas variables a su archivo `.env` en su lugar.
</Warning>
## Funciones sin servidor
Twenty admite funciones sin servidor para flujos de trabajo y lógica personalizada. El entorno de ejecución se configura mediante la variable de entorno `SERVERLESS_TYPE`.
<Warning>
**Aviso de seguridad:** El controlador local sin servidor (`SERVERLESS_TYPE=LOCAL`) ejecuta código directamente en el host en un proceso de Node.js sin aislamiento. Solo debe utilizarse para código de confianza en desarrollo. Para implementaciones de producción que manejen código no confiable, recomendamos encarecidamente usar `SERVERLESS_TYPE=LAMBDA` o `SERVERLESS_TYPE=DISABLED`.
</Warning>
### Controladores disponibles
| Controlador | Variable de entorno | Caso de uso | Nivel de seguridad |
| ----------- | -------------------------- | --------------------------------------------------- | -------------------------------------- |
| Desactivado | `SERVERLESS_TYPE=DISABLED` | Desactivar completamente las funciones sin servidor | N/A |
| Local | `SERVERLESS_TYPE=LOCAL` | Entornos de desarrollo y de confianza | Bajo (sin aislamiento) |
| Lambda | `SERVERLESS_TYPE=LAMBDA` | Producción con código no confiable | Alto (aislamiento a nivel de hardware) |
### Configuración recomendada
**Para desarrollo:**
```bash
SERVERLESS_TYPE=LOCAL # default
```
**Para producción (AWS):**
```bash
SERVERLESS_TYPE=LAMBDA
SERVERLESS_LAMBDA_REGION=us-east-1
SERVERLESS_LAMBDA_ROLE=arn:aws:iam::123456789:role/your-lambda-role
SERVERLESS_LAMBDA_ACCESS_KEY_ID=your-access-key
SERVERLESS_LAMBDA_SECRET_ACCESS_KEY=your-secret-key
```
**Para desactivar las funciones sin servidor:**
```bash
SERVERLESS_TYPE=DISABLED
```
<Note>
Al usar `SERVERLESS_TYPE=DISABLED`, cualquier intento de ejecutar una función sin servidor devolverá un error. Esto es útil si desea ejecutar Twenty sin capacidades de funciones sin servidor.
</Note>
packages/twenty-docs/l/es/developers/self-host/capabilities/troubleshooting.mdx
+88 -89
View File
@@ -1,26 +1,25 @@
---
title: Troubleshooting
title: Solución de problemas
---
## Troubleshooting
## Solución de Problemas
If you encounter any problem while setting up environment for development, upgrading your instance or self-hosting,
here are some solutions for common problems.
Si encuentra algún problema al configurar el entorno para el desarrollo, al actualizar su instancia o al autoalojar, aquí hay algunas soluciones para problemas comunes.
### Self-hosting
### Autoalojamiento
#### First install results in `password authentication failed for user "postgres"`
#### La primera instalación resulta en `fallo de autenticación de contraseña para el usuario "postgres"`
🚨 **IMPORTANT: This solution is ONLY for fresh installations** 🚨
If you have an existing Twenty instance with production data, **DO NOT** follow these steps as they will permanently delete your database!
🚨 **IMPORTANTE: Esta solución es SOLO para instalaciones nuevas** 🚨
Si tiene una instancia de Twenty existente con datos de producción, **NO** siga estos pasos ya que borrarán permanentemente su base de datos.
While installing Twenty for the first time, you might want to change the default database password.
The password you set during the first installation becomes permanently stored in the database volume. If you later try to change this password in your configuration without removing the old volume, you'll get authentication errors because the database is still using the original password.
Al instalar Twenty por primera vez, es posible que desee cambiar la contraseña predeterminada de la base de datos.
La contraseña que establezca durante la primera instalación se almacena permanentemente en el volumen de base de datos. Si más tarde intenta cambiar esta contraseña en su configuración sin eliminar el volumen anterior, obtendrá errores de autenticación porque la base de datos todavía está usando la contraseña original.
⚠️ WARNING: Following steps will PERMANENTLY DELETE all database data! ⚠️
Only proceed if this is a fresh installation with no important data.
⚠️ ADVERTENCIA: ¡Seguir los pasos borrará PERMANENTEMENTE todos los datos de la base de datos! ⚠️
Prosiga solo si se trata de una instalación nueva sin datos importantes.
In order to update the `PG_DATABASE_PASSWORD` you need to:
Para actualizar el `PG_DATABASE_PASSWORD` necesita:
```sh
# Update the PG_DATABASE_PASSWORD in .env
@@ -28,33 +27,33 @@ docker compose down --volumes
docker compose up -d
```
#### CR line breaks found [Windows]
#### Rupturas de línea de CR encontradas [Windows]
This is due to the line break characters of Windows and the git configuration. Try running:
Esto se debe a los caracteres de salto de línea de Windows y a la configuración de Git. Intente ejecutar:
```
git config --global core.autocrlf false
```
Then delete the repository and clone it again.
Luego elimine el repositorio y clónelo de nuevo.
#### Missing metadata schema
#### Esquema de metadatos faltante
During Twenty installation, you need to provision your postgres database with the right schemas, extensions, and users.
If you're successful in running this provisioning, you should have `default` and `metadata` schemas in your database.
If you don't, make sure you don't have more than one postgres instance running on your computer.
Durante la instalación de Twenty, debe aprovisionar su base de datos postgres con los esquemas, extensiones y usuarios correctos.
Si ha ejecutado con éxito este aprovisionamiento, debería tener esquemas `default` y `metadata` en su base de datos.
Si no los tiene, asegúrese de no tener más de una instancia de postgres ejecutándose en su computadora.
#### Cannot find module 'twenty-emails' or its corresponding type declarations.
#### No se puede encontrar el módulo 'twenty-emails' o sus declaraciones de tipo correspondientes.
You have to build the package `twenty-emails` before running the initialization of the database with `npx nx run twenty-emails:build`
Tienes que construir el paquete `twenty-emails` antes de ejecutar la inicialización de la base de datos con `npx nx run twenty-emails:build`
#### Missing twenty-x package
#### Falta el paquete twenty-x
Make sure to run yarn in the root directory and then run `npx nx server:dev twenty-server`. If this still doesn't work try building the missing package manually.
Asegúrese de ejecutar yarn en el directorio raíz y luego ejecute `npx nx server:dev twenty-server`. Si esto aún no funciona, intente construir el paquete faltante manualmente.
#### Lint on Save not working
#### Lint on Save no funciona
This should work out of the box with the eslint extension installed. If this doesn't work try adding this to your vscode setting (on the dev container scope):
Esto debería funcionar sin configuración adicional con la extensión de ESLint instalada. Si esto no funciona, intente agregar esto a su configuración de vscode (en el ámbito del contenedor de desarrollo):
```
"editor.codeActionsOnSave": {
@@ -64,85 +63,85 @@ This should work out of the box with the eslint extension installed. If this doe
}
```
#### While running `npx nx start` or `npx nx start twenty-front`, Out of memory error is thrown
#### Al ejecutar `npx nx start` o `npx nx start twenty-front`, se produce un error de falta de memoria
In `packages/twenty-front/.env` uncomment `VITE_DISABLE_TYPESCRIPT_CHECKER=true` to disable background checks thus reducing amount of needed RAM.
En `packages/twenty-front/.env` descomente `VITE_DISABLE_TYPESCRIPT_CHECKER=true` y `VITE_DISABLE_ESLINT_CHECKER=true` para deshabilitar las comprobaciones en segundo plano y así reducir la cantidad de RAM necesaria.
**If it does not work:**
Run only the services you need, instead of `npx nx start`. For instance, if you work on the server, run only `npx nx worker twenty-server`
**Si no funciona:**
Ejecute solo los servicios que necesite, en lugar de `npx nx start`. Por ejemplo, si trabaja en el servidor, ejecute solo `npx nx worker twenty-server`
**If it does not work:**
If you tried to run only `npx nx run twenty-server:start` on WSL and it's failing with the below memory error:
**Si no funciona:**
Si intentó ejecutar solo `npx nx run twenty-server:start` en WSL y falla con el siguiente error de memoria:
`FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory`
`ERROR FATAL: Las marcas compactas ineficaces cercanas al límite del montón Falló la asignación - JavaScript heap out of memory`
Workaround is to execute below command in terminal or add it in .bashrc profile to get setup automatically:
La solución es ejecutar el siguiente comando en el terminal o agregarlo en el perfil .bashrc para configurarlo automáticamente:
`export NODE_OPTIONS="--max-old-space-size=8192"`
The --max-old-space-size=8192 flag sets an upper limit of 8GB for the Node.js heap; usage scales with application demand.
Reference: https://stackoverflow.com/questions/56982005/where-do-i-set-node-options-max-old-space-size-2048
La bandera --max-old-space-size=8192 establece un límite superior de 8GB para el montón de Node.js; su uso escala con la demanda de la aplicación.
Referencia: https://stackoverflow.com/questions/56982005/where-do-i-set-node-options-max-old-space-size-2048
**If it does not work:**
Investigate which processes are taking you most of your machine RAM. At Twenty, we noticed that some VScode extensions were taking a lot of RAM so we temporarily disable them.
**Si no funciona:**
Investigue qué procesos están ocupando la mayor parte de la RAM de su máquina. En Twenty, notamos que algunas extensiones de VScode estaban ocupando mucha RAM, por lo que las desactivamos temporalmente.
**If it does not work:**
Restart your machine helps to clean up ghost processes.
**Si no funciona:**
Reiniciar su máquina ayuda a limpiar procesos fantasma.
#### While running `npx nx start` there are weird [0] and [1] in logs
#### Mientras ejecuta `npx nx start` hay [0] y [1] extraños en los registros
That's expected as command `npx nx start` is running more commands under the hood
Es esperado, ya que el comando `npx nx start` está ejecutando más comandos detrás de escena.
#### No emails are sent
#### No se envían correos electrónicos
Most of the time, it's because the `worker` is not running in the background. Try to run
La mayoría de las veces, se debe a que el `worker` no se está ejecutando en segundo plano. Intente ejecutar
```
npx nx worker twenty-server
```
#### Cannot connect my Microsoft 365 account
#### No se puede conectar mi cuenta de Microsoft 365
Most of the time, it's because your admin has not enabled the Microsoft 365 Licence for your account. Check [https://admin.microsoft.com/](https://admin.microsoft.com/Adminportal/Home).
La mayoría de las veces, se debe a que su administrador no ha habilitado la licencia de Microsoft 365 para su cuenta. Verifique [https://admin.microsoft.com/](https://admin.microsoft.com/Adminportal/Home).
If you have an error code `AADSTS50020`, it probably means that you are using a personal Microsoft account. This is not supported yet. More info [here](https://learn.microsoft.com/fr-fr/troubleshoot/entra/entra-id/app-integration/error-code-aadsts50020-user-account-identity-provider-does-not-exist)
Si tiene un código de error `AADSTS50020`, probablemente significa que está usando una cuenta de Microsoft personal. Esto aún no es compatible. Más información [aquí](https://learn.microsoft.com/fr-fr/troubleshoot/entra/entra-id/app-integration/error-code-aadsts50020-user-account-identity-provider-does-not-exist)
#### While running `yarn` warnings appear in console
#### Mientras ejecuta `yarn` aparecen advertencias en la consola
Warnings are informing about pulling additional dependencies which aren't explicitly stated in `package.json`, so as long as no breaking error appears, everything should work as expected.
Las advertencias informan sobre la carga de dependencias adicionales que no están explicitadas en `package.json`, así que mientras no aparezca un error crítico, todo debería funcionar como se espera.
#### When user accesses login page, error about unauthorized user trying to access workspace appears in logs
#### Cuando el usuario accede a la página de inicio de sesión, aparece un error sobre un usuario no autorizado que intenta acceder al espacio de trabajo en los registros
That's expected as user is unauthorized when logged out since its identity is not verified.
Es esperado ya que el usuario no está autorizado cuando cierra sesión porque su identidad no está verificada.
#### How to check if your worker is running?
#### ¿Cómo comprobar si su worker está funcionando?
* Go to [webhook-test.com](https://webhook-test.com/) and copy **Your Unique Webhook URL**.
* Vaya a [webhook-test.com](https://webhook-test.com/) y copie **Su URL de Webhook Única**.
<div style={{textAlign: 'center'}}>
<img src="/images/docs/developers/self-hosting/webhook-test.jpg" alt="Webhook test" />
<img src="/images/docs/developers/self-hosting/webhook-test.jpg" alt="Prueba de webhook" />
</div>
* Open your Twenty app, navigate to `/settings`, and enable the **Advanced** toggle at the bottom left of the screen.
* Create a new webhook.
* Paste **Your Unique Webhook URL** in the **Endpoint Url** field in Twenty. Set the **Filters** to `Companies` and `Created`.
* Abra la aplicación Twenty, navegue a `/settings` y active el interruptor **Avanzado** en la parte inferior izquierda de la pantalla.
* Cree un nuevo webhook.
* Pegue **Su URL de Webhook Única** en el campo **Url de EndPoint** en Twenty. Establezca los **Filtros** en `Companies` y `Created`.
<div style={{textAlign: 'center'}}>
<img src="/images/docs/developers/self-hosting/webhook-settings.jpg" alt="Webhook settings" />
<img src="/images/docs/developers/self-hosting/webhook-settings.jpg" alt="Configuraciones del webhook" />
</div>
* Go to `/objects/companies` and create a new company record.
* Return to [webhook-test.com](https://webhook-test.com/) and check if a new **POST request** has been received.
* Vaya a `/objects/companies` y cree un nuevo registro de empresa.
* Regrese a [webhook-test.com](https://webhook-test.com/) y verifique si se ha recibido una nueva **solicitud POST**.
<div style={{textAlign: 'center'}}>
<img src="/images/docs/developers/self-hosting/webhook-test-result.jpg" alt="Webhook test result" />
<img src="/images/docs/developers/self-hosting/webhook-test-result.jpg" alt="Resultado de la prueba del webhook" />
</div>
* If a **POST request** is received, your worker is running successfully. Otherwise, you need to troubleshoot your worker.
* Si se recibe una **solicitud POST**, su worker está funcionando con éxito. De lo contrario, debe solucionar problemas de su worker.
#### Front-end fails to start and returns error TS5042: Option 'project' cannot be mixed with source files on a command line
#### El front-end no comienza y devuelve el error TS5042: La opción 'project' no se puede mezclar con archivos fuente en una línea de comando
Comment out checker plugin in `packages/twenty-ui/vite-config.ts` like in example below
Comente el plugin checker en `packages/twenty-ui/vite-config.ts` como en el ejemplo a continuación
```
plugins: [
@@ -166,62 +165,62 @@ plugins: [
],
```
#### Admin panel not accessible
#### Panel de administración no accesible
Run `UPDATE core."user" SET "canAccessFullAdminPanel" = TRUE WHERE email = 'you@yourdomain.com';` in database container to get access to admin panel.
Ejecute `UPDATE core."user" SET "canAccessFullAdminPanel" = TRUE WHERE email = 'you@yourdomain.com';` en el contenedor de la base de datos para obtener acceso al panel de administración.
### 1-click Docker compose
### 1-clic con Docker Compose
#### Unable to Log In
#### No se puede iniciar sesión
If you can't log in after setup:
Si no puedes iniciar sesión después de la configuración:
1. Run the following commands:
1. Ejecución de los siguientes comandos:
```bash
docker exec -it twenty-server-1 yarn
docker exec -it twenty-server-1 npx nx database:reset --configuration=no-seed
```
2. Restart the Docker containers:
2. Reinicie los contenedores de Docker:
```bash
docker compose down
docker compose up -d
```
Note the database:reset command will completely erase your database and recreate it from scratch.
Tenga en cuenta que el comando database:reset borrará toda su base de datos y la recreará desde cero.
#### Connection Issues Behind a Reverse Proxy
#### Problemas de conexión detrás de un Proxy Reverso
If you're running Twenty behind a reverse proxy and experiencing connection issues:
Si está ejecutando Twenty detrás de un proxy inverso y experimenta problemas de conexión:
1. **Verify SERVER_URL:**
1. **Verifique SERVER_URL:**
Ensure `SERVER_URL` in your `.env` file matches your external access URL, including `https` if SSL is enabled.
Asegúrese de que `SERVER_URL` en su archivo `.env` coincida con su URL de acceso externa, incluyendo `https` si SSL está habilitado.
2. **Check Reverse Proxy Settings:**
2. **Verifique la configuración del Proxy Reverso:**
* Confirm that your reverse proxy is correctly forwarding requests to the Twenty server.
* Ensure headers like `X-Forwarded-For` and `X-Forwarded-Proto` are properly set.
* Confirme que su proxy reverso está reenviando correctamente las solicitudes al servidor de Twenty.
* Asegúrese de que los encabezados como `X-Forwarded-For` y `X-Forwarded-Proto` estén configurados correctamente.
3. **Restart Services:**
3. **Reinicie los Servicios:**
After making changes, restart both the reverse proxy and Twenty containers.
Después de hacer cambios, reinicie tanto el proxy inverso como los contenedores de Twenty.
#### Error when uploading an image - permission denied
#### Error al cargar una imagen - permiso denegado
Switching the data folder ownership on the host from root to another user and group resolves this problem.
Cambiar la propiedad de la carpeta de datos en el host de raíz a otro usuario y grupo resuelve este problema.
## Getting Help
## Obtención de Ayuda
If you encounter issues not covered in this guide:
Si enfrenta problemas no cubiertos en esta guía:
* Check Logs:
* Verifique los Registros:
View container logs for error messages:
Vea los registros del contenedor por mensajes de error:
```bash
docker compose logs
```
* Community Support:
* Soporte Comunitario:
Reach out to the [Twenty community](https://github.com/twentyhq/twenty/issues) or [support channels](https://discord.gg/cx5n4Jzs57) for assistance.
Póngase en contacto con la [comunidad de Twenty](https://github.com/twentyhq/twenty/issues) o [los canales de soporte](https://discord.gg/cx5n4Jzs57) para obtener asistencia.
packages/twenty-docs/l/es/developers/self-host/capabilities/upgrade-guide.mdx
+140 -140
View File
@@ -1,40 +1,40 @@
---
title: Upgrade guide
title: Guía de actualización
---
## General guidelines
## Guías generales
**Always make sure to back up your database before starting the upgrade process** by running `docker exec -it {db_container_name_or_id} pg_dumpall -U {postgres_user} > databases_backup.sql`.
**Asegúrese siempre de respaldar su base de datos antes de iniciar el proceso de actualización** ejecutando `docker exec -it {db_container_name_or_id} pg_dumpall -U {postgres_user} > databases_backup.sql`.
To restore backup, run `cat databases_backup.sql | docker exec -i {db_container_name_or_id} psql -U {postgres_user}`.
Para restaurar el respaldo, ejecute `cat databases_backup.sql | docker exec -i {db_container_name_or_id} psql -U {postgres_user}`.
If you used Docker Compose, follow these steps:
Si usó Docker Compose, siga estos pasos:
1. In a terminal, on the host where Twenty is running, turn off Twenty: `docker compose down`
1. En una terminal, en el host donde Twenty está funcionando, apague Twenty: `docker compose down`
2. Upgrade the version by changing the `TAG` value in the .env file near your docker-compose. ( We recommend consuming `major.minor` version such as `v0.53` )
2. Actualice la versión cambiando el valor de `TAG` en el archivo .env cerca de su docker-compose. ( Recomendamos consumir la versión `major.minor` como `v0.53` )
3. Bring Twenty back online with `docker compose up -d`
3. Vuelva a conectar Twenty con `docker compose up -d`
If you want to upgrade your instance by few versions, e.g. from v0.33.0 to v0.35.0, you have to upgrade your instance sequentially, in this example from v0.33.0 to v0.34.0, then from v0.34.0 to v0.35.0.
Si desea actualizar su instancia por algunas versiones, por ejemplo de v0.33.0 a v0.35.0, debe actualizar su instancia secuencialmente, en este ejemplo de v0.33.0 a v0.34.0, luego de v0.34.0 a v0.35.0.
**Make sure that after each upgraded version you have non-corrupted backup.**
**Asegúrese de que después de cada versión actualizada tenga una copia de respaldo no corrupta.**
## Version-specific upgrade steps
## Pasos de actualización específicos por versión
## v1.0
Hello Twenty v1.0! 🎉
¡Hola Twenty v1.0! 🎉
## v0.60
### Performance Enhancements
### Mejoras de rendimiento
All interactions with the metadata API have been optimized for better performance, particularly for object metadata manipulation and workspace creation operations.
Todas las interacciones con la API de metadatos han sido optimizadas para un mejor rendimiento, particularmente para la manipulación de metadatos de objetos y operaciones de creación de espacios de trabajo.
We've refactored our caching strategy to prioritize cache hits over database queries when possible, significantly improving the performance of metadata API operations.
Hemos reestructurado nuestra estrategia de almacenamiento en caché para priorizar los aciertos de caché sobre las consultas de base de datos cuando sea posible, mejorando significativamente el rendimiento de las operaciones de la API de metadatos.
If you encounter any runtime issues after upgrading, you may need to flush your cache to ensure it's synchronized with the latest changes. Run this command in your twenty-server container:
Si encuentra problemas de ejecución después de actualizar, es posible que deba vaciar su caché para asegurar que esté sincronizado con los cambios más recientes. Ejecute este comando en su contenedor del servidor de twenty:
```bash
yarn command:prod cache:flush
@@ -42,113 +42,113 @@ yarn command:prod cache:flush
### v0.55
Upgrade your Twenty instance to use v0.55 image
Actualice su instancia de Twenty para usar la imagen v0.55
You don't need to run any command anymore, the new image will automatically care about running all required migrations.
Ya no necesita ejecutar ningún comando, la nueva imagen se encargará automáticamente de ejecutar todas las migraciones necesarias.
### `User does not have permission` error
### Error: `El usuario no tiene permiso`
If you encounter authorization errors on most requests after upgrading, you may need to flush your cache to recompute the latest permissions.
Si encuentra errores de autorización en la mayoría de solicitudes después de actualizar, es posible que deba vaciar su caché para recalcular los permisos más recientes.
In your `twenty-server` container, run:
En su contenedor `twenty-server`, ejecute:
```bash
yarn command:prod cache:flush
```
This issue is specific to this Twenty version and should not be required for future upgrades.
Este problema es específico de esta versión de Twenty y no debería ser necesario para futuras actualizaciones.
### v0.54
Since version `0.53`, no manual actions needed.
Desde la versión `0.53`, no se necesitan acciones manuales.
#### Metadata schema deprecation
#### Desaparición del esquema de metadatos
We've merged the `metadata` schema into the `core` one to simplify data retrieval from `TypeORM`.
We have merged the `migrate` command step within the `upgrade` command. We do not recommend running `migrate` manually within any of your server/worker containers.
Hemos fusionado el esquema `metadata` en el esquema `core` para simplificar la recuperación de datos desde `TypeORM`.
Hemos fusionado el paso del comando `migrate` dentro del comando `upgrade`. No recomendamos ejecutar `migrate` manualmente dentro de ninguno de sus contenedores de servidor/trabajador.
### Since v0.53
### Desde v0.53
Starting from `0.53`, upgrade is programmatically done within the `DockerFile`, this means from now on, you shouldn't have to run any command manually anymore.
A partir de `0.53`, la actualización se realiza de forma programática dentro del `DockerFile`, esto significa que de ahora en adelante, no debería necesitar ejecutar ningún comando manualmente.
Make sure to keep upgrading your instance sequentially, without skipping any major version (e.g. `0.43.3` to `0.44.0` is allowed, but `0.43.1` to `0.45.0` isn't), else could lead to workspace version desynchronization that could result in runtime error and missing functionality.
Asegúrese de seguir actualizando su instancia secuencialmente, sin omitir ninguna versión principal (por ejemplo, de `0.43.3` a `0.44.0` está permitido, pero de `0.43.1` a `0.45.0` no lo está), de lo contrario, podría provocar un desincronización de la versión del espacio de trabajo que podría resultar en errores de ejecución y funciones faltantes.
To check if a workspace has been correctly migrated you can review its version in database in `core.workspace` table.
Para verificar si un espacio de trabajo se ha migrado correctamente, puede revisar su versión en la base de datos en la tabla `core.workspace`.
It should always be in the range of your current Twenty's instance `major.minor` version, you can view your instance version in the admin panel (at `/settings/admin-panel`, accessible if your user has `canAccessFullAdminPanel` property set to true in the database) or by running `echo $APP_VERSION` in your `twenty-server` container.
Siempre debería estar dentro del rango de la versión `major.minor` actual de su instancia de Twenty; puede ver la versión de su instancia en el panel de administración (en `/settings/admin-panel`, accesible si su usuario tiene la propiedad `canAccessFullAdminPanel` establecida en verdadero en la base de datos) o ejecutando `echo $APP_VERSION` en su contenedor `twenty-server`.
To fix a desynchronized workspace version, you will have to upgrade from the corresponding twenty's version following related upgrade guide sequentially and so on until it reaches desired version.
Para corregir una versión de espacio de trabajo desincronizada, tendrá que actualizar desde la correspondiente versión de twenty siguiendo la guía de actualización relacionada secuencialmente, y así sucesivamente hasta alcanzar la versión deseada.
#### `auditLog` removal
#### Eliminación de `auditLog`
We've removed the auditLog standard object, which means your backup size might be significantly reduced after this migration.
Hemos eliminado el objeto estándar auditLog, lo que significa que el tamaño de su copia de seguridad podría reducirse significativamente después de esta migración.
### v0.51 to v0.52
### v0.51 a v0.52
Upgrade your Twenty instance to use v0.52 image
Actualice su instancia de Twenty para usar la imagen v0.52
```
yarn database:migrate:prod
yarn command:prod upgrade
```
#### I have a workspace blocked in version between `0.52.0` and `0.52.6`
#### Tengo un espacio de trabajo bloqueado en la versión entre `0.52.0` y `0.52.6`
Unfortunately `0.52.0` and `0.52.6` have been completely removed from dockerHub.
You will have to manually update your workspace version to `0.51.0` in database and upgrade using twenty version `0.52.11` following its just above upgrade guide.
Desafortunadamente, `0.52.0` y `0.52.6` se han eliminado completamente de dockerHub.
Tendrá que actualizar manualmente la versión de su espacio de trabajo a `0.51.0` en la base de datos y actualizar usando la versión twenty `0.52.11` siguiendo su guía de actualización justo arriba.
### v0.50 to v0.51
### v0.50 a v0.51
Upgrade your Twenty instance to use v0.51 image
Actualice su instancia de Twenty para usar la imagen v0.51
```
yarn database:migrate:prod
yarn command:prod upgrade
```
### v0.44.0 to v0.50.0
### v0.44.0 a v0.50.0
Upgrade your Twenty instance to use v0.50.0 image
Actualice su instancia de Twenty para usar la imagen v0.50.0
```
yarn database:migrate:prod
yarn command:prod upgrade
```
#### Docker-compose.yml mutation
#### Mutación del docker-compose.yml
This version includes a `docker-compose.yml` mutation to give `worker` service access to the `server-local-data` volume.
Please update your local `docker-compose.yml` with [v0.50.0 docker-compose.yml](https://github.com/twentyhq/twenty/blob/v0.50.0/packages/twenty-docker/docker-compose.yml)
Esta versión incluye una mutación del `docker-compose.yml` para dar acceso al servicio `worker` al volumen `server-local-data`.
Actualice su `docker-compose.yml` local con el [docker-compose.yml de v0.50.0](https://github.com/twentyhq/twenty/blob/v0.50.0/packages/twenty-docker/docker-compose.yml)
### v0.43.0 to v0.44.0
### v0.43.0 a v0.44.0
Upgrade your Twenty instance to use v0.44.0 image
Actualice su instancia de Twenty para usar la imagen v0.44.0
```
yarn database:migrate:prod
yarn command:prod upgrade
```
### v0.42.0 to v0.43.0
### v0.42.0 a v0.43.0
Upgrade your Twenty instance to use v0.43.0 image
Actualice su instancia de Twenty para usar la imagen v0.43.0
```
yarn database:migrate:prod
yarn command:prod upgrade
```
In this version, we have also switched to postgres:16 image in docker-compose.yml.
En esta versión, también hemos cambiado a la imagen de postgres:16 en docker-compose.yml.
#### (Option 1) Database migration
#### (Opción 1) Migración de base de datos
Keeping the existing postgres-spilo image is fine, but you will have to freeze the version in your docker-compose.yml to be 0.43.0.
Mantener la imagen postgres-spilo existente está bien, pero tendrá que congelar la versión en su docker-compose.yml a 0.43.0.
#### (Option 2) Database migration
#### (Opción 2) Migración de base de datos
If you want to migrate your database to the new postgres:16 image, please follow these steps:
Si desea migrar su base de datos a la nueva imagen de postgres:16, siga estos pasos:
1. Dump your database from the old postgres-spilo container
1. Descargue su base de datos del contenedor antiguo de postgres-spilo
```
docker exec -it twenty-db-1 sh
@@ -157,11 +157,11 @@ exit
docker cp twenty-db-1:/home/postgres/databases_backup.sql .
```
Make sure your dump file is not empty.
Asegúrese de que su archivo de respaldo no esté vacío.
2. Upgrade your docker-compose.yml to use postgres:16 image as in the [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml) file.
2. Actualice su docker-compose.yml para usar la imagen de postgres:16 como en el archivo [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml).
3. Restore the database to the new postgres:16 container
3. Restaure la base de datos al nuevo contenedor postgres:16
```
docker cp databases_backup.sql twenty-db-1:/databases_backup.sql
@@ -170,86 +170,86 @@ psql -U {YOUR_POSTGRES_USER} -d {YOUR_POSTGRES_DB} -f databases_backup.sql
exit
```
### v0.41.0 to v0.42.0
### v0.41.0 a v0.42.0
Upgrade your Twenty instance to use v0.42.0 image
Actualice su instancia de Twenty para usar la imagen v0.42.0
```
yarn database:migrate:prod
yarn command:prod upgrade-0.42
```
**Environment Variables**
**Variables del entorno**
* Removed: `FRONT_PORT`, `FRONT_PROTOCOL`, `FRONT_DOMAIN`, `PORT`
* Added: `FRONTEND_URL`, `NODE_PORT`, `MAX_NUMBER_OF_WORKSPACES_DELETED_PER_EXECUTION`, `MESSAGING_PROVIDER_MICROSOFT_ENABLED`, `CALENDAR_PROVIDER_MICROSOFT_ENABLED`, `IS_MICROSOFT_SYNC_ENABLED`
* Removidos: `FRONT_PORT`, `FRONT_PROTOCOL`, `FRONT_DOMAIN`, `PORT`
* Agregados: `FRONTEND_URL`, `NODE_PORT`, `MAX_NUMBER_OF_WORKSPACES_DELETED_PER_EXECUTION`, `MESSAGING_PROVIDER_MICROSOFT_ENABLED`, `CALENDAR_PROVIDER_MICROSOFT_ENABLED`, `IS_MICROSOFT_SYNC_ENABLED`
### v0.40.0 to v0.41.0
### v0.40.0 a v0.41.0
Upgrade your Twenty instance to use v0.41.0 image
Actualice su instancia de Twenty para usar la imagen v0.41.0
```
yarn database:migrate:prod
yarn command:prod upgrade-0.41
```
**Environment Variables**
**Variables del entorno**
* Removed: `AUTH_MICROSOFT_TENANT_ID`
* Removido: `AUTH_MICROSOFT_TENANT_ID`
### v0.35.0 to v0.40.0
### v0.35.0 a v0.40.0
Upgrade your Twenty instance to use v0.40.0 image
Actualice su instancia de Twenty para usar la imagen v0.40.0
```
yarn database:migrate:prod
yarn command:prod upgrade-0.40
```
**Environment Variables**
**Variables del entorno**
* Added: `IS_EMAIL_VERIFICATION_REQUIRED`, `EMAIL_VERIFICATION_TOKEN_EXPIRES_IN`, `WORKFLOW_EXEC_THROTTLE_LIMIT`, `WORKFLOW_EXEC_THROTTLE_TTL`
* Agregados: `IS_EMAIL_VERIFICATION_REQUIRED`, `EMAIL_VERIFICATION_TOKEN_EXPIRES_IN`, `WORKFLOW_EXEC_THROTTLE_LIMIT`, `WORKFLOW_EXEC_THROTTLE_TTL`
### v0.34.0 to v0.35.0
### v0.34.0 a v0.35.0
Upgrade your Twenty instance to use v0.35.0 image
Actualice su instancia de Twenty para usar la imagen v0.35.0
```
yarn database:migrate:prod
yarn command:prod upgrade-0.35
```
The `yarn database:migrate:prod` command will apply the migrations to the database structure (core and metadata schemas)
The `yarn command:prod upgrade-0.35` takes care of the data migration of all workspaces.
El comando `yarn database:migrate:prod` aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
El `yarn command:prod upgrade-0.35` se encarga de la migración de datos de todos los espacios de trabajo.
**Environment Variables**
**Variables del entorno**
* We replaced `ENABLE_DB_MIGRATIONS` with `DISABLE_DB_MIGRATIONS` (default value is now `false`, you probably don't have to set anything)
* Reemplazamos `ENABLE_DB_MIGRATIONS` por `DISABLE_DB_MIGRATIONS` (valor predeterminado ahora es `false`, probablemente no tenga que establecer nada)
### v0.33.0 to v0.34.0
### v0.33.0 a v0.34.0
Upgrade your Twenty instance to use v0.34.0 image
Actualice su instancia de Twenty para usar la imagen v0.34.0
```
yarn database:migrate:prod
yarn command:prod upgrade-0.34
```
The `yarn database:migrate:prod` command will apply the migrations to the database structure (core and metadata schemas)
The `yarn command:prod upgrade-0.34` takes care of the data migration of all workspaces.
El comando `yarn database:migrate:prod` aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
El `yarn command:prod upgrade-0.34` se encarga de la migración de datos de todos los espacios de trabajo.
**Environment Variables**
**Variables del entorno**
* Removed: `FRONT_BASE_URL`
* Added: `FRONT_DOMAIN`, `FRONT_PROTOCOL`, `FRONT_PORT`
* Removido: `FRONT_BASE_URL`
* Agregados: `FRONT_DOMAIN`, `FRONT_PROTOCOL`, `FRONT_PORT`
We have updated the way we handle the frontend URL.
You can now set the frontend URL using the `FRONT_DOMAIN`, `FRONT_PROTOCOL` and `FRONT_PORT` variables.
If FRONT_DOMAIN is not set, the frontend URL will fall back to `SERVER_URL`.
Hemos actualizado la forma en que manejamos la URL del frontend.
Ahora puede configurar la URL del frontend usando las variables `FRONT_DOMAIN`, `FRONT_PROTOCOL` y `FRONT_PORT`.
Si FRONT_DOMAIN no está configurado, la URL del frontend volverá a `SERVER_URL`.
### v0.32.0 to v0.33.0
### v0.32.0 a v0.33.0
Upgrade your Twenty instance to use v0.33.0 image
Actualice su instancia de Twenty para usar la imagen v0.33.0
```
yarn command:prod cache:flush
@@ -257,68 +257,68 @@ yarn database:migrate:prod
yarn command:prod upgrade-0.33
```
The `yarn command:prod cache:flush` command will flush the Redis cache.
The `yarn database:migrate:prod` command will apply the migrations to the database structure (core and metadata schemas)
The `yarn command:prod upgrade-0.33` takes care of the data migration of all workspaces.
El comando `yarn command:prod cache:flush` eliminará la caché de Redis.
El comando `yarn database:migrate:prod` aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
El `yarn command:prod upgrade-0.33` se encarga de la migración de datos de todos los espacios de trabajo.
Starting from this version, twenty-postgres image for DB became deprecated and twenty-postgres-spilo is used instead.
If you want to keep using twenty-postgres image, simply replace `twentycrm/twenty-postgres:${TAG}` with `twentycrm/twenty-postgres` in docker-compose.yml.
A partir de esta versión, la imagen twenty-postgres para DB quedó obsoleta y ahora se usa twenty-postgres-spilo.
Si desea seguir usando la imagen twenty-postgres, simplemente reemplace `twentycrm/twenty-postgres:${TAG}` con `twentycrm/twenty-postgres` en docker-compose.yml.
### v0.31.0 to v0.32.0
### v0.31.0 a v0.32.0
Upgrade your Twenty instance to use v0.32.0 image
Actualice su instancia de Twenty para usar la imagen v0.32.0
**Schema and data migration**
**Migración de esquemas y datos**
```
yarn database:migrate:prod
yarn command:prod upgrade-0.32
```
The `yarn database:migrate:prod` command will apply the migrations to the database structure (core and metadata schemas)
The `yarn command:prod upgrade-0.32` takes care of the data migration of all workspaces.
El comando `yarn database:migrate:prod` aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
El `yarn command:prod upgrade-0.32` se encarga de la migración de datos de todos los espacios de trabajo.
**Environment Variables**
**Variables del entorno**
We have updated the way we handle the Redis connection.
Hemos actualizado la forma en que manejamos la conexión Redis.
* Removed: `REDIS_HOST`, `REDIS_PORT`, `REDIS_USERNAME`, `REDIS_PASSWORD`
* Added: `REDIS_URL`
* Removidos: `REDIS_HOST`, `REDIS_PORT`, `REDIS_USERNAME`, `REDIS_PASSWORD`
* Agregado: `REDIS_URL`
Update your `.env` file to use the new `REDIS_URL` variable instead of the individual Redis connection parameters.
Actualice su archivo `.env` para usar la nueva variable `REDIS_URL` en lugar de los parámetros de conexión individuales de Redis.
We have also simplified the way we handle the JWT tokens.
También hemos simplificado la forma en que manejamos los tokens JWT.
* Removed: `ACCESS_TOKEN_SECRET`, `LOGIN_TOKEN_SECRET`, `REFRESH_TOKEN_SECRET`, `FILE_TOKEN_SECRET`
* Added: `APP_SECRET`
* Removidos: `ACCESS_TOKEN_SECRET`, `LOGIN_TOKEN_SECRET`, `REFRESH_TOKEN_SECRET`, `FILE_TOKEN_SECRET`
* Agregado: `APP_SECRET`
Update your `.env` file to use the new `APP_SECRET` variable instead of the individual tokens secrets (you can use the same secret as before or generate a new random string)
Actualice su archivo `.env` para usar la nueva variable `APP_SECRET` en lugar de los secretos de tokens individuales (puede usar el mismo secreto que antes o generar una nueva cadena aleatoria)
**Connected Account**
**Cuenta conectada**
If you are using connected account to synchronize your Google emails and calendars, you will need to activate the [People API](https://developers.google.com/people) on your Google Admin console.
Si está utilizando cuentas conectadas para sincronizar sus correos electrónicos y calendarios de Google, deberá activar la [API de People](https://developers.google.com/people) en su consola de administración de Google.
### v0.30.0 to v0.31.0
### v0.30.0 a v0.31.0
Upgrade your Twenty instance to use v0.31.0 image
Actualice su instancia de Twenty para usar la imagen v0.31.0
**Schema and data migration**:
**Migración de esquemas y datos:**
```
yarn database:migrate:prod
yarn command:prod upgrade-0.31
```
The `yarn database:migrate:prod` command will apply the migrations to the database structure (core and metadata schemas)
The `yarn command:prod upgrade-0.31` takes care of the data migration of all workspaces.
El comando `yarn database:migrate:prod` aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
El `yarn command:prod upgrade-0.31` se encarga de la migración de datos de todos los espacios de trabajo.
### v0.24.0 to v0.30.0
### v0.24.0 a v0.30.0
Upgrade your Twenty instance to use v0.30.0 image
Actualice su instancia de Twenty para usar la imagen v0.30.0
**Breaking change**:
To enhance performances, Twenty now requires redis cache to be configured. We have updated our [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml) to reflect this.
Make sure to update your configuration and to update your environment variables accordingly:
**Cambio importante**:
Para mejorar el rendimiento, Twenty ahora requiere que la caché redis esté configurada. Hemos actualizado nuestro [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml) para reflejar esto.
Asegúrese de actualizar su configuración y sus variables de entorno en consecuencia:
```
REDIS_HOST={your-redis-host}
@@ -326,49 +326,49 @@ REDIS_PORT={your-redis-port}
CACHE_STORAGE_TYPE=redis
```
**Schema and data migration**:
**Migración de esquemas y datos:**
```
yarn database:migrate:prod
yarn command:prod upgrade-0.30
```
The `yarn database:migrate:prod` command will apply the migrations to the database structure (core and metadata schemas)
The `yarn command:prod upgrade-0.30` takes care of the data migration of all workspaces.
El comando `yarn database:migrate:prod` aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
El `yarn command:prod upgrade-0.30` se encarga de la migración de datos de todos los espacios de trabajo.
### v0.23.0 to v0.24.0
### v0.23.0 a v0.24.0
Upgrade your Twenty instance to use v0.24.0 image
Actualice su instancia de Twenty para usar la imagen v0.24.0
Run the following commands:
Ejecución de los siguientes comandos:
```
yarn database:migrate:prod
yarn command:prod upgrade-0.24
```
The `yarn database:migrate:prod` command will apply the migrations to the database structure (core and metadata schemas)
The `yarn command:prod upgrade-0.24` takes care of the data migration of all workspaces.
El comando `yarn database:migrate:prod` aplicará las migraciones a la estructura de la base de datos (esquemas core y metadata)
El `yarn command:prod upgrade-0.24` se encarga de la migración de datos de todos los espacios de trabajo.
### v0.22.0 to v0.23.0
### v0.22.0 a v0.23.0
Upgrade your Twenty instance to use v0.23.0 image
Actualice su instancia de Twenty para usar la imagen v0.23.0
Run the following commands:
Ejecución de los siguientes comandos:
```
yarn database:migrate:prod
yarn command:prod upgrade-0.23
```
The `yarn database:migrate:prod` command will apply the migrations to the Database.
The `yarn command:prod upgrade-0.23` takes care of the data migration, including transferring activities to tasks/notes.
El comando `yarn database:migrate:prod` aplicará las migraciones a la base de datos.
El `yarn command:prod upgrade-0.23` se encarga de la migración de datos, incluyendo la transferencia de actividades a tareas/notas.
### v0.21.0 to v0.22.0
### v0.21.0 a v0.22.0
Upgrade your Twenty instance to use v0.22.0 image
Actualice su instancia de Twenty para usar la imagen v0.22.0
Run the following commands:
Ejecución de los siguientes comandos:
```
yarn database:migrate:prod
@@ -376,6 +376,6 @@ yarn command:prod workspace:sync-metadata -f
yarn command:prod upgrade-0.22
```
The `yarn database:migrate:prod` command will apply the migrations to the Database.
The `yarn command:prod workspace:sync-metadata -f` command will sync the definition of standard objects to the metadata tables and apply to required migrations to existing workspaces.
The `yarn command:prod upgrade-0.22` command will apply specific data transformations to adapt to the new object defaultRequestInstrumentationOptions.
El comando `yarn database:migrate:prod` aplicará las migraciones a la base de datos.
El comando `yarn command:prod workspace:sync-metadata -f` sincronizará la definición de objetos estándar a las tablas de metadatos y aplicará las migraciones requeridas a los espacios de trabajo existentes.
El comando `yarn command:prod upgrade-0.22` aplicará transformaciones de datos específicas para adaptarse a las nuevas opciones predeterminadas de instrumentación de solicitud de objetos.