i18n - docs translations (#17433)
Created by Github action Co-authored-by: github-actions <github-actions@twenty.com>
This commit is contained in:
github-actions[bot]
committed by
GitHub
GitHub
parent
c8c821a692
commit
2353bc62cc
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user