i18n - docs translations (#17434)

Created by Github action

Co-authored-by: github-actions <github-actions@twenty.com>
This commit is contained in:
github-actions[bot]
2026-01-26 09:06:17 +01:00
committed by GitHub
parent 2353bc62cc
commit e0d4492013
651 changed files with 37463 additions and 32557 deletions
@@ -1,45 +1,45 @@
---
title: Other methods
title: Outros métodos
---
<Warning>
This document is maintained by the community. It might contain issues.
Este documento é mantido pela comunidade. Pode conter problemas.
</Warning>
## Kubernetes via Terraform and Manifests
## Kubernetes via Terraform e Manifests
Community-led documentation for Kubernetes deployment is available [here](https://github.com/twentyhq/twenty/tree/main/packages/twenty-docker/k8s)
A documentação liderada pela comunidade para a implantação do Kubernetes está disponível [aqui](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)
Implante o Twenty em servidores usando o Coolify. (imagem oficial no Coolify estará disponível em breve)
[Coolify documentation](https://coolify.io/docs/get-started/introduction)
[Documentação Coolify](https://coolify.io/docs/get-started/introduction)
### EasyPanel
Deploy Twenty on EasyPanel with the community maintained template below.
Implante o Twenty no EasyPanel com o modelo mantido pela comunidade abaixo.
[Deploy on EasyPanel](https://easypanel.io/docs/templates/twenty)
[Implante no EasyPanel](https://easypanel.io/docs/templates/twenty)
### Elest.io
Deploy Twenty on servers with Elest.io using link below.
Implante o Twenty em servidores com Elest.io usando o link abaixo.
[Deploy on Elest.io](https://elest.io/open-source/twenty)
[Implante no Elest.io](https://elest.io/open-source/twenty)
### Twenty on Railway
### Twenty no Railway
Deploy Twenty on Railway with the community maintained template below.
Implante o Twenty no Railway com o modelo mantido pela comunidade abaixo.
[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/nAL3hA)
[![Implante no Railway](https://railway.com/button.svg)](https://railway.com/deploy/nAL3hA)
### Twenty on Sealos
### Twenty no Sealos
Deploy Twenty on Sealos with the community maintained template below.
Implante o Twenty no Sealos com o modelo mantido pela comunidade abaixo.
[![Deploy on Sealos](https://sealos.io/Deploy-on-Sealos.svg)](https://sealos.io/products/app-store/twenty)
[![Implante no Sealos](https://sealos.io/Deploy-on-Sealos.svg)](https://sealos.io/products/app-store/twenty)
## Others
## Outros
Please feel free to Open a PR to add more Cloud Provider options.
Sinta-se à vontade para abrir um PR para adicionar mais opções de Provedor de Nuvem.
@@ -1,253 +1,253 @@
---
title: 1-Click w/ Docker Compose
title: 1-Clique c/ Docker Compose
---
<Warning>
Docker containers are for production hosting or self-hosting, for the contribution please check the [Local Setup](/l/pt/developers/contribute/capabilities/local-setup).
Contêineres Docker são para hospedagem de produção ou auto-hospedagem, para contribuições, por favor, verifique o [Setup Local](/l/pt/developers/contribute/capabilities/local-setup).
</Warning>
## Overview
## Visão geral
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.
Este guia fornece instruções passo a passo para instalar e configurar o aplicativo Twenty usando Docker Compose. O objetivo é tornar o processo simples e evitar armadilhas comuns que possam quebrar sua configuração.
**Important:** Only modify settings explicitly mentioned in this guide. Altering other configurations may lead to issues.
**Importante:** Modifique apenas as configurações explicitamente mencionadas neste guia. Alterar outras configurações pode levar a problemas.
See docs [Setup Environment Variables](/l/pt/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.
Veja a documentação [Configurar Variáveis de Ambiente](/l/pt/developers/self-host/capabilities/setup) para configuração avançada. Todas as variáveis de ambiente devem ser declaradas no arquivo docker-compose.yml no nível do servidor e/ou trabalhador, dependendo da variável.
## System Requirements
## Requisitos do 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: Certifique-se de que seu ambiente tenha pelo menos 2GB de RAM. Memória insuficiente pode causar falhas nos processos.
* Docker & Docker Compose: Certifique-se de que ambos estão instalados e atualizados.
## Option 1: One-line script
## Opção 1: Script de uma linha
Install the latest stable version of Twenty with a single command:
Instale a versão estável mais recente do Twenty com um único 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 uma versão ou branch 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.
* Substitua x.y.z pelo número da versão desejada.
* Substitua branch-name pelo nome da branch que você deseja instalar.
## Option 2: Manual steps
## Opção 2: Etapas manuais
Follow these steps for a manual setup.
Siga estas etapas para uma configuração manual.
### Step 1: Set Up the Environment File
### Etapa 1: Configure o arquivo de ambiente
1. **Create the .env File**
1. **Crie o arquivo .env**
Copy the example environment file to a new .env file in your working directory:
Copie o exemplo de arquivo de ambiente para um novo arquivo .env no seu diretório de trabalho:
```bash
curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/.env.example
```
2. **Generate Secret Tokens**
2. **Gere Tokens Secretos**
Run the following command to generate a unique random string:
Execute o seguinte comando para gerar uma string aleatória única:
```bash
openssl rand -base64 32
```
**Important:** Keep this value secret / do not share it.
**Importante:** Mantenha este valor em segredo / não o compartilhe.
3. **Update the `.env`**
3. **Atualize o `.env`**
Replace the placeholder value in your .env file with the generated token:
Substitua o valor do espaço reservado no seu arquivo .env pelo token gerado:
```ini
APP_SECRET=first_random_string
```
4. **Set the Postgres Password**
4. **Defina a Senha do Postgres**
Update the `PG_DATABASE_PASSWORD` value in the .env file with a strong password without special characters.
Atualize o valor `PG_DATABASE_PASSWORD` no arquivo .env com uma senha forte sem caracteres especiais.
```ini
PG_DATABASE_PASSWORD=my_strong_password
```
### Step 2: Obtain the Docker Compose File
### Etapa 2: Obtenha o arquivo Docker Compose
Download the `docker-compose.yml` file to your working directory:
Baixe o arquivo `docker-compose.yml` para o seu diretório de trabalho:
```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
### Etapa 3: Inicie o Aplicativo
Start the Docker containers:
Inicie os contêineres Docker:
```bash
docker compose up -d
```
### Step 4: Access the Application
### Etapa 4: Acesse o Aplicativo
If you host twentyCRM on your own computer, open your browser and navigate to [http://localhost:3000](http://localhost:3000).
Se você hospedar o twentyCRM no seu próprio computador, abra o navegador e acesse [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
Se você hospedar em um servidor, verifique se o servidor está em execução e se está tudo ok com
```bash
curl http://localhost:3000
```
## Configuration
## Configuração
### Expose Twenty to External Access
### Expor o Twenty para Acesso 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 padrão, o Twenty é executado em `localhost` na porta `3000`. Para acessá-lo via um domínio externo ou endereço IP, você precisa configurar o `SERVER_URL` no seu arquivo `.env`.
#### Understanding `SERVER_URL`
#### Compreendendo `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:** Use `http` ou `https` dependendo da sua configuração.
* Use `http` se você não configurou SSL.
* Use `https` se você tiver SSL configurado.
* **Domínio/IP:** Este é o nome de domínio ou endereço IP onde seu aplicativo está acessível.
* **Porta:** Inclua o número da porta se você não estiver usando as portas padrão (`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) é necessário para que certos recursos do navegador funcionem corretamente. Embora esses recursos possam funcionar durante o desenvolvimento local (já que os navegadores tratam o localhost de modo diferente), é necessária uma configuração adequada de SSL ao hospedar o Twenty em um domínio normal.
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 exemplo, a API da área de transferência pode exigir um contexto seguro - alguns recursos, como botões de cópia através do aplicativo, podem não funcionar sem HTTPS ativado.
We strongly recommend setting up Twenty behind a reverse proxy with SSL termination for optimal security and functionality.
Recomendamos fortemente configurar o Twenty atrás de um proxy reverso com terminação SSL para segurança e funcionalidade ótimas.
#### Configuring `SERVER_URL`
#### Configurando `SERVER_URL`
1. **Determine Your Access URL**
* **Without Reverse Proxy (Direct Access):**
1. **Determine sua URL de Acesso**
* **Sem Proxy Reverso (Acesso Direto):**
If you're accessing the application directly without a reverse proxy:
Se você estiver acessando o aplicativo diretamente sem um proxy reverso:
```ini
SERVER_URL=http://your-domain-or-ip:3000
```
* **With Reverse Proxy (Standard Ports):**
* **Com Proxy Reverso (Portas Padrão):**
If you're using a reverse proxy like Nginx or Traefik and have SSL configured:
Se você estiver usando um proxy reverso como Nginx ou Traefik e tiver SSL configurado:
```ini
SERVER_URL=https://your-domain-or-ip
```
* **With Reverse Proxy (Custom Ports):**
* **Com Proxy Reverso (Portas Customizadas):**
If you're using non-standard ports:
Se você estiver usando portas não-padrão:
```ini
SERVER_URL=https://your-domain-or-ip:custom-port
```
2. **Update the `.env` File**
2. **Atualize o arquivo `.env`**
Open your `.env` file and update the `SERVER_URL`:
Abra seu arquivo `.env` e atualize o `SERVER_URL`:
```ini
SERVER_URL=http(s)://your-domain-or-ip:your-port
```
**Examples:**
**Exemplos:**
* Direct access without SSL:
* Acesso direto sem SSL:
```ini
SERVER_URL=http://123.45.67.89:3000
```
* Access via domain with SSL:
* Acesso via domínio com SSL:
```ini
SERVER_URL=https://mytwentyapp.com
```
3. **Restart the Application**
3. **Reinicie o Aplicativo**
For changes to take effect, restart the Docker containers:
Para que as alterações entrem em vigor, reinicie os contêineres Docker:
```bash
docker compose down
docker compose up -d
```
#### Considerations
#### Considerações
* **Reverse Proxy Configuration:**
* **Configuração de Proxy Reverso:**
Ensure your reverse proxy forwards requests to the correct internal port (`3000` by default). Configure SSL termination and any necessary headers.
Certifique-se de que seu proxy reverso encaminha as solicitações para a porta interna correta (`3000` por padrão). Configure a terminação SSL e quaisquer cabeçalhos necessários.
* **Firewall Settings:**
* **Configurações de Firewall:**
Open necessary ports in your firewall to allow external access.
Abra as portas necessárias no seu firewall para permitir acesso externo.
* **Consistency:**
* **Consistência:**
The `SERVER_URL` must match how users access your application in their browsers.
A `SERVER_URL` deve corresponder à forma como os usuários acessam seu aplicativo nos navegadores.
#### Persistence
#### Persistência
* **Data Volumes:**
* **Volumes de Dados:**
The Docker Compose configuration uses volumes to persist data for the database and server storage.
A configuração do Docker Compose usa volumes para persistir dados para o banco de dados e armazenamento do servidor.
* **Stateless Environments:**
* **Ambientes Sem Estado:**
If deploying to a stateless environment (e.g., certain cloud services), configure external storage to persist data.
Se estiver implantando em um ambiente sem estado (por exemplo, certos serviços de nuvem), configure armazenamento externo para persistir dados.
## Backup and Restore
## Backup e restauração
Regular backups protect your CRM data from loss.
Backups regulares protegem os dados do seu CRM contra perda.
### Create a Database Backup
### Crie um backup do banco de dados
```bash
docker exec twenty-postgres pg_dump -U postgres twenty > backup_$(date +%Y%m%d).sql
```
### Automate Daily Backups
### Automatize backups diários
Add to your crontab (`crontab -e`):
Adicione ao seu 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
### Restaurar a partir de um backup
1. Stop the application:
1. Pare o aplicativo:
```bash
docker compose stop twenty-server twenty-front
```
2. Restore the database:
2. Restaure o banco de dados:
```bash
docker exec -i twenty-postgres psql -U postgres twenty < backup_20240115.sql
```
3. Restart services:
3. Reinicie os serviços:
```bash
docker compose up -d
```
### Backup Best Practices
### Melhores práticas de backup
* **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
* **Teste as restaurações regularmente** — verifique se os backups realmente funcionam
* **Armazene os backups fora das instalações** — use armazenamento em nuvem (S3, GCS, etc.)
* **Criptografe dados confidenciais** — proteja os backups com criptografia
* **Mantenha várias cópias** — guarde backups diários, semanais e mensais
## Troubleshooting
## Resolução de Problemas
If you encounter any problem, check [Troubleshooting](/l/pt/developers/self-host/capabilities/troubleshooting) for solutions.
Se encontrar algum problema, verifique [Resolução de Problemas](/l/pt/developers/self-host/capabilities/troubleshooting) para soluções.
@@ -1,146 +1,146 @@
---
title: Setup
title: Configuração
---
# Configuration Management
# Gestão de Configuração
<Warning>
**First time installing?** Follow the [Docker Compose installation guide](/l/pt/developers/self-host/capabilities/docker-compose) to get Twenty running, then return here for configuration.
**Primeira vez instalando?** Siga o [guia de instalação do Docker Compose](/l/pt/developers/self-host/capabilities/docker-compose) para iniciar o Twenty, depois retorne aqui para configurar.
</Warning>
Twenty offers **two configuration modes** to suit different deployment needs:
Twenty oferece **dois modos de configuração** para atender diferentes necessidades de implantação:
**Admin panel access:** Only users with admin privileges (`canAccessFullAdminPanel: true`) can access the configuration interface.
**Acesso ao painel de administração:** Apenas usuários com privilégios de administrador (`canAccessFullAdminPanel: true`) podem acessar a interface de configuração.
## 1. Admin Panel Configuration (Default)
## 1. Configuração do Painel Administrativo (Padrão)
```bash
IS_CONFIG_VARIABLES_IN_DB_ENABLED=true # default
```
**Most configuration happens through the UI** after installation:
**A maior parte da configuração acontece através da interface do usuário** após a instalação:
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. Acesse sua instância do Twenty (geralmente `http://localhost:3000`)
2. Vá para **Configurações / Painel de Administração / Variáveis de Configuração**
3. Configure integrações, email, armazenamento e mais
4. As alterações entram em vigor imediatamente (em até 15 segundos para implantações em múltiplos containers)
<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).
**Implantações em Múltiplos Containers:** Ao usar a configuração do banco de dados (`IS_CONFIG_VARIABLES_IN_DB_ENABLED=true`), tanto servidores quanto containers de trabalho leem do mesmo banco de dados. Alterações no painel de administração afetam ambos automaticamente, eliminando a necessidade de duplicar variáveis de ambiente entre os containers (exceto para variáveis de infraestrutura).
</Warning>
**What you can configure through the admin panel:**
**O que você pode configurar através do painel de administração:**
* **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...**
* **Autenticação** - OAuth do Google/Microsoft, configurações de senha
* **Email** - configurações SMTP, modelos, verificação
* **Armazenamento** - configuração S3, caminhos de armazenamento local
* **Integrações** - Gmail, Google Calendar, serviços Microsoft
* **Fluxo de trabalho e limitação de taxa** - limites de execução, limitação de taxa da API
* **E muito mais...**
![Admin Panel Configuration Variables](/images/user-guide/setup/admin-panel-config-variables.png)
![Variáveis de configuração do painel de administração](/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 variável é documentada com descrições no seu painel de administração em **Configurações → Painel de Administração → Variáveis de Configuração**.
Algumas configurações de infraestrutura como conexões de banco de dados (`PG_DATABASE_URL`), URLs de servidor (`SERVER_URL`) e segredos do app (`APP_SECRET`) só podem ser configuradas via arquivo `.env`.
[Complete technical reference →](https://github.com/twentyhq/twenty/blob/main/packages/twenty-server/src/engine/core-modules/twenty-config/config-variables.ts)
[Referência 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. Configuração Somente por Ambiente
```bash
IS_CONFIG_VARIABLES_IN_DB_ENABLED=false
```
**All configuration managed through `.env` files:**
**Toda a configuração gerenciada através de arquivos `.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. Defina `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false` no seu arquivo `.env`
2. Adicione todas as variáveis de configuração ao seu arquivo `.env`
3. Reinicie os containers para que as alterações entrem em vigor
4. O painel de administração mostrará valores atuais, mas não poderá modificá-los
## Multi-Workspace Mode
## Modo de vários espaços de trabalho
By default, Twenty runs in **single-workspace mode** — ideal for most self-hosted deployments where you need one CRM instance for your organization.
Por padrão, o Twenty é executado no **modo de espaço de trabalho único** — ideal para a maioria das implantações auto-hospedadas em que você precisa de uma instância de CRM para sua organização.
### Single-Workspace Mode (Default)
### Modo de espaço de trabalho único (padrão)
```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`
* Um espaço de trabalho por instância do Twenty
* O primeiro usuário torna-se automaticamente administrador com privilégios completos (`canImpersonate` e `canAccessFullAdminPanel`)
* Novos cadastros são desativados após a criação do primeiro espaço de trabalho
* Estrutura de URL simples: `https://your-domain.com`
### Enabling Multi-Workspace Mode
### Ativando o modo de vários espaços de trabalho
```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.
Ative o modo de vários espaços de trabalho para implantações ao estilo SaaS em que várias equipes independentes precisam de seus próprios espaços de trabalho na mesma instância do Twenty.
**Key differences from single-workspace mode:**
**Principais diferenças em relação ao modo de espaço de trabalho único:**
* 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
* Vários espaços de trabalho podem ser criados na mesma instância
* Cada espaço de trabalho recebe seu próprio subdomínio (por exemplo, `sales.your-domain.com`, `marketing.your-domain.com`)
* Os usuários se cadastram e fazem login em `{DEFAULT_SUBDOMAIN}.your-domain.com` (por exemplo, `app.your-domain.com`)
* Sem privilégios administrativos automáticos — o primeiro usuário de cada espaço de trabalho é um usuário comum
* Configurações específicas do espaço de trabalho, como subdomínio e domínio personalizado, ficam disponíveis nas configurações do espaço de trabalho
<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.
**Configuração apenas por ambiente:** `IS_MULTIWORKSPACE_ENABLED` só pode ser configurado via arquivo `.env` e requer reinicialização. Isso não pode ser alterado pelo painel de administração.
</Warning>
### DNS Configuration for Multi-Workspace
### Configuração de DNS para vários espaços de trabalho
When using multi-workspace mode, configure your DNS with a wildcard record to allow dynamic subdomain creation:
Ao usar o modo de vários espaços de trabalho, configure seu DNS com um registro curinga para permitir a criação dinâmica de subdomínios:
```
*.your-domain.com -> your-server-ip
```
This enables automatic subdomain routing for new workspaces without manual DNS configuration.
Isso permite o roteamento automático de subdomínios para novos espaços de trabalho sem configuração manual de DNS.
### Restricting Workspace Creation
### Restringindo a criação de espaços de trabalho
In multi-workspace mode, you may want to limit who can create new workspaces:
No modo de vários espaços de trabalho, você pode querer limitar quem pode criar novos espaços de trabalho:
```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.
Quando ativado, apenas usuários com `canAccessFullAdminPanel` podem criar espaços de trabalho adicionais. Os usuários ainda podem criar seu primeiro espaço de trabalho durante o cadastro inicial.
## Gmail & Google Calendar Integration
## Integração com Gmail e Google Calendar
### Create Google Cloud Project
### Criar Projeto no 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. Vá para [Google Cloud Console](https://console.cloud.google.com/)
2. Crie um novo projeto ou selecione um já existente
3. Ative essas 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)
* [API do Gmail](https://console.cloud.google.com/apis/library/gmail.googleapis.com)
* [API do Google Calendar](https://console.cloud.google.com/apis/library/calendar-json.googleapis.com)
* [API de Pessoas](https://console.cloud.google.com/apis/library/people.googleapis.com)
### Configure 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. Vá para [Credenciais](https://console.cloud.google.com/apis/credentials)
2. Crie um ID do Cliente OAuth 2.0
3. Adicione estes URIs de redirecionamento:
* `https://{your-domain}/auth/google/redirect` (para SSO)
* `https://{your-domain}/auth/google-apis/get-access-token` (para integrações)
### Configure in Twenty
### Configurar no Twenty
1. Go to **Settings → Admin Panel → Configuration Variables**
2. Find the **Google Auth** section
3. Set these variables:
1. Vá para **Configurações → Painel de Administração → Variáveis de Configuração**
2. Encontre a seção **Google Auth**
3. Defina estas variáveis:
* `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 somente ambiente:** Se você definir `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, adicione estas variáveis ao seu arquivo `.env`.
</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)
**Escopos necessários** (configurados automaticamente):
[Veja o código 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
### Se seu aplicativo estiver em modo de teste
If your app is in test mode, you will need to add test users to your project.
Se seu aplicativo estiver em modo de teste, será necessário adicionar usuários de teste ao seu projeto.
Under [OAuth consent screen](https://console.cloud.google.com/apis/credentials/consent), add your test users to the "Test users" section.
Na [tela de consentimento OAuth](https://console.cloud.google.com/apis/credentials/consent), adicione seus usuários de teste à seção "Usuários de teste".
## Microsoft 365 Integration
## Integração com 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.
Os usuários devem ter uma [Licença do Microsoft 365](https://admin.microsoft.com/Adminportal/Home) para poder usar as APIs de Calendário e Mensagem. Eles não poderão sincronizar sua conta no Twenty sem uma.
</Warning>
### Create a project in Microsoft Azure
### Criar um projeto no 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.
Você precisará criar um projeto no [Microsoft Azure](https://portal.azure.com/#view/Microsoft_AAD_IAM/AppGalleryBladeV2) e obter as credenciais.
### Enable APIs
### Habilitar APIs
On Microsoft Azure Console enable the following APIs in "Permissions":
No Console do Microsoft Azure habilite as seguintes APIs em "Permissões":
* 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" e "Mail.Send" são apenas obrigatórios se você quiser enviar emails usando nossas ações de fluxo de trabalho. Você pode usar "Mail.Read" em vez disso se quiser apenas receber emails.
### Authorized redirect URIs
### URIs de redirecionamento autorizados
You need to add the following redirect URIs to your project:
Você precisa adicionar os seguintes URIs de redirecionamento ao seu projeto:
* `https://{your-domain}/auth/microsoft/redirect` if you want to use Microsoft SSO
* `https://{your-domain}/auth/microsoft/redirect` se você quiser usar SSO da Microsoft
* `https://{your-domain}/auth/microsoft-apis/get-access-token`
### Configure in Twenty
### Configurar no Twenty
1. Go to **Settings → Admin Panel → Configuration Variables**
2. Find the **Microsoft Auth** section
3. Set these variables:
1. Vá para **Configurações → Painel de Administração → Variáveis de Configuração**
2. Encontre a seção **Microsoft Auth**
3. Defina estas variáveis:
* `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 somente ambiente:** Se você definir `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, adicione estas variáveis ao seu arquivo `.env`.
</Warning>
### Configure scopes
### Configurar escopos
[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)
[Veja o código 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'
* 'perfil'
* 'offline_access'
* 'Mail.ReadWrite'
* 'Mail.Send'
* 'Calendars.Read'
### If your app is in test mode
### Se seu aplicativo estiver em modo de teste
If your app is in test mode, you will need to add test users to your project.
Se seu aplicativo estiver em modo de teste, será necessário adicionar usuários de teste ao seu projeto.
Add your test users to the "Users and groups" section.
Adicione seus usuários de teste à seção "Usuários e grupos".
## Background Jobs for Calendar & Messaging
## Trabalhos em Segundo Plano para Calendário e Mensagens
After configuring Gmail, Google Calendar, or Microsoft 365 integrations, you need to start the background jobs that sync data.
Após configurar integrações com Gmail, Google Calendar ou Microsoft 365, é necessário iniciar os trabalhos em segundo plano que sincronizam dados.
Register the following recurring jobs in your worker container:
Registre os seguintes trabalhos recorrentes em seu container de trabalho:
```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
## Configuração de Email
1. Go to **Settings → Admin Panel → Configuration Variables**
2. Find the **Email** section
3. Configure your SMTP settings:
1. Vá para **Configurações → Painel de Administração → Variáveis de Configuração**
2. Encontre a seção **Email**
3. Configure suas configurações SMTP:
<ArticleTabs label1="Gmail" label2="Office365" label3="Smtp4dev">
<ArticleTab>
You will need to provision an [App Password](https://support.google.com/accounts/answer/185833).
Você precisará provisionar uma [Senha de App](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).
Lembre-se de que, se você tiver 2FA ativado, precisará providenciar uma [Senha de App](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** é um servidor SMTP falso para desenvolvimento e teste.
* 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:
* Execute a imagem smtp4dev: `docker run --rm -it -p 8090:80 -p 2525:25 rnwood/smtp4dev`
* Acesse a interface smtp4dev aqui: [http://localhost:8090](http://localhost:8090)
* Defina as seguintes variáveis:
* 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 somente ambiente:** Se você definir `IS_CONFIG_VARIABLES_IN_DB_ENABLED=false`, adicione estas variáveis ao seu arquivo `.env`.
</Warning>
## Funções serverless
O Twenty oferece suporte a funções serverless para fluxos de trabalho e lógica personalizada. O ambiente de execução é configurado por meio da variável de ambiente `SERVERLESS_TYPE`.
<Warning>
**Aviso de segurança:** O driver serverless local (`SERVERLESS_TYPE=LOCAL`) executa código diretamente no host em um processo Node.js sem sandbox. Deve ser usado apenas para código confiável em desenvolvimento. Para implantações de produção que lidam com código não confiável, recomendamos fortemente usar `SERVERLESS_TYPE=LAMBDA` ou `SERVERLESS_TYPE=DISABLED`.
</Warning>
### Drivers disponíveis
| Driver | Variável de ambiente | Caso de uso | Nível de segurança |
| ---------- | -------------------------- | --------------------------------------------- | -------------------------------------- |
| Desativado | `SERVERLESS_TYPE=DISABLED` | Desativar completamente as funções serverless | N/A |
| Local | `SERVERLESS_TYPE=LOCAL` | Desenvolvimento e ambientes confiáveis | Baixo (sem sandbox) |
| Lambda | `SERVERLESS_TYPE=LAMBDA` | Produção com código não confiável | Alto (isolamento em nível de hardware) |
### Configuração recomendada
**Para desenvolvimento:**
```bash
SERVERLESS_TYPE=LOCAL # default
```
**Para produção (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 desativar as funções serverless:**
```bash
SERVERLESS_TYPE=DISABLED
```
<Note>
Ao usar `SERVERLESS_TYPE=DISABLED`, qualquer tentativa de executar uma função serverless retornará um erro. Isso é útil se você quiser executar o Twenty sem recursos de funções serverless.
</Note>
@@ -1,26 +1,25 @@
---
title: Troubleshooting
title: Resolução de Problemas
---
## Troubleshooting
## Resolução 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.
Se encontrar algum problema ao configurar o ambiente para desenvolvimento, atualizar sua instância ou auto-hospedagem, aqui estão algumas soluções para problemas comuns.
### Self-hosting
### Auto-hospedagem
#### First install results in `password authentication failed for user "postgres"`
#### Primeira instalação resulta em `falha na autenticação de senha para o usuário "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 solução é APENAS para instalações novas** 🚨
Se você tiver uma instância existente do Twenty com dados em produção, **NÃO** siga estes passos, pois eles excluirão permanentemente seu banco de dados!
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.
Ao instalar o Twenty pela primeira vez, você pode querer alterar a senha padrão do banco de dados.
A senha definida durante a primeira instalação é armazenada permanentemente no volume do banco de dados. Se posteriormente tentar alterar esta senha na sua configuração sem remover o volume antigo, receberá erros de autenticação porque o banco de dados ainda está usando a senha original.
⚠️ WARNING: Following steps will PERMANENTLY DELETE all database data! ⚠️
Only proceed if this is a fresh installation with no important data.
⚠️ AVISO: Seguir os próximos passos irá EXCLUIR PERMANENTEMENTE todos os dados do banco de dados! ⚠️
Prossiga apenas se esta for uma instalação nova, sem dados importantes.
In order to update the `PG_DATABASE_PASSWORD` you need to:
Para atualizar o `PG_DATABASE_PASSWORD` você precisa:
```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]
#### Quebras de linha CR encontradas [Windows]
This is due to the line break characters of Windows and the git configuration. Try running:
Isso se deve aos caracteres de quebra de linha do Windows e à configuração do git. Tente executar:
```
git config --global core.autocrlf false
```
Then delete the repository and clone it again.
Depois exclua o repositório e clone novamente.
#### Missing metadata schema
#### Esquema de metadados ausente
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 a instalação do Twenty, é necessário configurar seu banco de dados postgres com os esquemas, extensões e usuários corretos.
Se conseguir executar esta configuração, você deve ter os esquemas `default` e `metadata` no seu banco de dados.
Se não, certifique-se de que não possui mais de uma instância do postgres em execução no seu computador.
#### Cannot find module 'twenty-emails' or its corresponding type declarations.
#### Não é possível encontrar o módulo 'twenty-emails' ou suas declarações de tipo correspondentes.
You have to build the package `twenty-emails` before running the initialization of the database with `npx nx run twenty-emails:build`
É preciso compilar o pacote `twenty-emails` antes de iniciar a inicialização do banco de dados com `npx nx run twenty-emails:build`
#### Missing twenty-x package
#### Pacote twenty-x ausente
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.
Certifique-se de executar o yarn no diretório raiz e depois executar `npx nx server:dev twenty-server`. Se isso ainda não funcionar, tente compilar manualmente o pacote ausente.
#### Lint on Save not working
#### Lint no Save não funcionando
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):
Isso deve funcionar automaticamente com a extensão eslint instalada. Se isso não funcionar, tente adicionar este trecho às suas configurações do vscode (no escopo do contêiner de desenvolvimento):
```
"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
#### Ao executar `npx nx start` ou `npx nx start twenty-front`, é lançada uma mensagem de erro de falta de memória
In `packages/twenty-front/.env` uncomment `VITE_DISABLE_TYPESCRIPT_CHECKER=true` to disable background checks thus reducing amount of needed RAM.
No `packages/twenty-front/.env` descomente `VITE_DISABLE_TYPESCRIPT_CHECKER=true` para desativar verificações em segundo plano, reduzindo assim a quantidade de RAM necessária.
**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`
**Se não funcionar:**
Execute apenas os serviços que precisar, em vez de `npx nx start`. Por exemplo, se estiver trabalhando no servidor, execute apenas `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:
**Se não funcionar:**
Se você tentou executar apenas `npx nx run twenty-server:start` no WSL e está falhando com o erro de memória abaixo:
`FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of memory`
`ERRO FATAL: Marcação ineficaz perto do limite de heap Alocação falhou - heap do JavaScript sem memória`
Workaround is to execute below command in terminal or add it in .bashrc profile to get setup automatically:
A solução alternativa é executar o comando abaixo no terminal ou adicioná-lo no perfil .bashrc para ser configurado automaticamente:
`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
O parâmetro --max-old-space-size=8192 define um limite superior de 8GB para o heap do Node.js; o uso escala conforme as demandas da aplicação.
Referência: 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.
**Se não funcionar:**
Investigue quais processos estão consumindo a maior parte da RAM do seu computador. No Twenty, percebemos que algumas extensões do VScode estavam consumindo muita RAM, então as desativamos temporariamente.
**If it does not work:**
Restart your machine helps to clean up ghost processes.
**Se não funcionar:**
Reiniciar sua máquina ajuda a limpar processos fantasmas.
#### While running `npx nx start` there are weird [0] and [1] in logs
#### Ao executar `npx nx start`, há logs estranhos [0] e [1]
That's expected as command `npx nx start` is running more commands under the hood
Isso é esperado, pois o comando `npx nx start` está executando mais comandos por trás dos bastidores
#### No emails are sent
#### Nenhum email é enviado
Most of the time, it's because the `worker` is not running in the background. Try to run
Na maioria das vezes, isso ocorre porque o `worker` não está sendo executado em segundo plano. Tente executar
```
npx nx worker twenty-server
```
#### Cannot connect my Microsoft 365 account
#### Não consigo conectar minha conta 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).
Na maioria das vezes, é porque seu administrador não ativou a Licença Microsoft 365 para sua conta. 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)
Se você tem um código de erro `AADSTS50020`, provavelmente significa que você está usando uma conta pessoal da Microsoft. Isso ainda não é suportado. Mais informações [aqui](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
#### Ao executar `yarn` avisos aparecem no console
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.
Os avisos informam sobre a obtenção de dependências adicionais que não estão explicitamente declaradas em `package.json`, portanto, desde que não apareça nenhum erro crítico, tudo deve funcionar como esperado.
#### When user accesses login page, error about unauthorized user trying to access workspace appears in logs
#### Quando o usuário acessa a página de login, aparece nos logs um erro sobre o usuário não autorizado tentando acessar o espaço de trabalho
That's expected as user is unauthorized when logged out since its identity is not verified.
Isso é esperado, pois o usuário fica sem autorização quando está desconectado, já que sua identidade não está verificada.
#### How to check if your worker is running?
#### Como verificar se seu worker está em execução?
* Go to [webhook-test.com](https://webhook-test.com/) and copy **Your Unique Webhook URL**.
* Vá para [webhook-test.com](https://webhook-test.com/) e copie **Sua URL de Webhook exclusiva**.
<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="Teste 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 seu aplicativo Twenty, navegue até `/settings`, e ative a alternância **Avançado** na parte inferior esquerda da tela.
* Crie um novo webhook.
* Cole **Sua URL Webhook Única** no campo **Endpoint Url** no Twenty. Defina os **Filtros** para `Companies` e `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="Configurações de 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.
* Vá para `/objects/companies` e crie um novo registro de empresa.
* Retorne para [webhook-test.com](https://webhook-test.com/) e verifique se uma nova **solicitação POST** foi recebida.
<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 do teste de webhook" />
</div>
* If a **POST request** is received, your worker is running successfully. Otherwise, you need to troubleshoot your worker.
* Se uma **solicitação POST** for recebida, seu worker está funcionando com sucesso. Caso contrário, você precisa solucionar problemas no seu worker.
#### Front-end fails to start and returns error TS5042: Option 'project' cannot be mixed with source files on a command line
#### Front-end não inicia e retorna erro TS5042: A opção 'project' não pode ser misturada com arquivos de origem na linha de comando
Comment out checker plugin in `packages/twenty-ui/vite-config.ts` like in example below
Comente o plugin checker em `packages/twenty-ui/vite-config.ts` como no exemplo abaixo
```
plugins: [
@@ -166,62 +165,62 @@ plugins: [
],
```
#### Admin panel not accessible
#### Painel administrativo não acessível
Run `UPDATE core."user" SET "canAccessFullAdminPanel" = TRUE WHERE email = 'you@yourdomain.com';` in database container to get access to admin panel.
Execute `UPDATE core."user" SET "canAccessFullAdminPanel" = TRUE WHERE email = 'você@seudominio.com';` no contêiner de banco de dados para obter acesso ao painel administrativo.
### 1-click Docker compose
### Docker compose com um clique
#### Unable to Log In
#### Impossível efetuar login
If you can't log in after setup:
Se você não consegue efetuar login após a configuração:
1. Run the following commands:
1. Execute os seguintes 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 os contêineres Docker:
```bash
docker compose down
docker compose up -d
```
Note the database:reset command will completely erase your database and recreate it from scratch.
Observe que o comando database:reset irá apagar completamente seu banco de dados e recriá-lo do zero.
#### Connection Issues Behind a Reverse Proxy
#### Problemas de conexão por trás de um proxy reverso
If you're running Twenty behind a reverse proxy and experiencing connection issues:
Se você está executando o Twenty por trás de um proxy reverso e está enfrentando problemas de conexão:
1. **Verify SERVER_URL:**
1. **Verifique o SERVER_URL:**
Ensure `SERVER_URL` in your `.env` file matches your external access URL, including `https` if SSL is enabled.
Certifique-se de que o `SERVER_URL` no seu arquivo `.env` corresponda à sua URL de acesso externo, incluindo `https` se o SSL estiver habilitado.
2. **Check Reverse Proxy Settings:**
2. **Verifique as configurações do 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 seu proxy reverso está encaminhando corretamente as solicitações para o servidor Twenty.
* Certifique-se de que cabeçalhos como `X-Forwarded-For` e `X-Forwarded-Proto` estão configurados corretamente.
3. **Restart Services:**
3. **Reinicie os Serviços:**
After making changes, restart both the reverse proxy and Twenty containers.
Após fazer as alterações, reinicie tanto o proxy reverso quanto os contêineres do Twenty.
#### Error when uploading an image - permission denied
#### Erro ao carregar uma imagem - permissão negada
Switching the data folder ownership on the host from root to another user and group resolves this problem.
Alterar a propriedade do diretório de dados no host de root para outro usuário e grupo resolve esse problema.
## Getting Help
## Obtendo Ajuda
If you encounter issues not covered in this guide:
Se encontrar problemas não abordados neste guia:
* Check Logs:
* Verifique os Logs:
View container logs for error messages:
Veja os logs dos contêineres para mensagens de erro:
```bash
docker compose logs
```
* Community Support:
* Suporte Comunitário:
Reach out to the [Twenty community](https://github.com/twentyhq/twenty/issues) or [support channels](https://discord.gg/cx5n4Jzs57) for assistance.
Entre em contato com a [comunidade Twenty](https://github.com/twentyhq/twenty/issues) ou [canais de suporte](https://discord.gg/cx5n4Jzs57) para obter assistência.
@@ -1,40 +1,40 @@
---
title: Upgrade guide
title: Guia de atualização
---
## General guidelines
## Diretrizes gerais
**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`.
**Certifique-se sempre de fazer backup do banco de dados antes de iniciar o processo de atualização** executando `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 o backup, execute `cat databases_backup.sql | docker exec -i {db_container_name_or_id} psql -U {postgres_user}`.
If you used Docker Compose, follow these steps:
Se você usou o Docker Compose, siga estas etapas:
1. In a terminal, on the host where Twenty is running, turn off Twenty: `docker compose down`
1. No terminal, no host onde o Twenty está em execução, desligue o 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. Atualize a versão alterando o valor `TAG` no arquivo .env próximo ao seu docker-compose. (Recomendamos consumir a versão `major.minor` como `v0.53`)
3. Bring Twenty back online with `docker compose up -d`
3. Traga o Twenty de volta ao ar com `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.
Se você quiser atualizar sua instância em algumas versões, por exemplo, de v0.33.0 para v0.35.0, você deve atualizar sua instância sequencialmente, neste exemplo de v0.33.0 para v0.34.0, depois de v0.34.0 para v0.35.0.
**Make sure that after each upgraded version you have non-corrupted backup.**
**Certifique-se de que após cada versão atualizada você tenha um backup não corrompido.**
## Version-specific upgrade steps
## Etapas de atualização específicas da versão
## v1.0
Hello Twenty v1.0! 🎉
Olá Twenty v1.0! 🎉
## v0.60
### Performance Enhancements
### Melhorias de Performance
All interactions with the metadata API have been optimized for better performance, particularly for object metadata manipulation and workspace creation operations.
Todas as interações com a API de metadados foram otimizadas para um melhor desempenho, particularmente para manipulação de metadados de objetos e operações de criação de espaço de trabalho.
We've refactored our caching strategy to prioritize cache hits over database queries when possible, significantly improving the performance of metadata API operations.
Reformulamos nossa estratégia de cache para priorizar acertos de cache em detrimento de consultas ao banco de dados sempre que possível, melhorando significativamente o desempenho das operações da API de metadados.
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:
Se você encontrar problemas de execução após a atualização, pode ser necessário limpar seu cache para garantir que esteja sincronizado com as alterações mais recentes. Execute este comando em seu contêiner do twenty-server:
```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
Atualize sua instância do Twenty para usar a imagem v0.55
You don't need to run any command anymore, the new image will automatically care about running all required migrations.
Você não precisa mais executar nenhum comando, a nova imagem cuidará automaticamente de executar todas as migrações necessárias.
### `User does not have permission` error
### Erro `User does not have permission`
If you encounter authorization errors on most requests after upgrading, you may need to flush your cache to recompute the latest permissions.
Se você encontrar erros de autorização na maioria das solicitações após a atualização, pode ser necessário limpar seu cache para recálculo das permissões mais recentes.
In your `twenty-server` container, run:
Em seu contêiner `twenty-server`, execute:
```bash
yarn command:prod cache:flush
```
This issue is specific to this Twenty version and should not be required for future upgrades.
Este problema é específico para esta versão do Twenty e não deverá ser necessário em futuras atualizações.
### v0.54
Since version `0.53`, no manual actions needed.
Desde a versão `0.53`, nenhuma ação manual é necessária.
#### Metadata schema deprecation
#### Desativação do esquema de metadados
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.
Mesclamos o esquema `metadata` no `core` para simplificar a recuperação de dados do `TypeORM`.
Mesclamos o passo do comando `migrate` dentro do comando `upgrade`. Não recomendamos a execução manual do `migrate` em nenhum de seus servidores/conteineres de trabalho.
### 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`, a atualização é feita programaticamente dentro do `DockerFile`, o que significa que, a partir de agora, você não precisará mais executar nenhum 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.
Certifique-se de manter atualizando sua instância sequencialmente, sem pular qualquer versão principal (por exemplo, `0.43.3` para `0.44.0` é permitido, mas `0.43.1` para `0.45.0` não é), caso contrário, pode levar a uma desincronização na versão do espaço de trabalho que pode resultar em erro de tempo de execução e funcionalidade ausente.
To check if a workspace has been correctly migrated you can review its version in database in `core.workspace` table.
Para verificar se um espaço de trabalho foi migrado corretamente, você pode revisar sua versão no banco de dados na tabela `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.
Deve estar sempre na faixa da versão `major.minor` atual da instância do Twenty, você pode ver a versão de sua instância no painel de administração (em `/settings/admin-panel`, acessível se seu usuário tiver a propriedade `canAccessFullAdminPanel` definida como verdadeira no banco de dados) ou executando `echo $APP_VERSION` em seu contêiner `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 corrigir uma versão de workspace dessincronizada, você terá que atualizar da versão correspondente do twenty seguindo o guia de atualização relacionado sequencialmente e assim por diante até alcançar a versão desejada.
#### `auditLog` removal
#### Remoção do `auditLog`
We've removed the auditLog standard object, which means your backup size might be significantly reduced after this migration.
Removemos o objeto padrão auditLog, o que significa que o tamanho do backup pode ser significativamente reduzido após esta migração.
### v0.51 to v0.52
### v0.51 para v0.52
Upgrade your Twenty instance to use v0.52 image
Atualize sua instância do Twenty para usar a imagem 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`
#### Tenho um espaço de trabalho bloqueado na versão entre `0.52.0` e `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.
Infelizmente, `0.52.0` e `0.52.6` foram completamente removidos do dockerHub.
Você terá que atualizar manualmente a versão do espaço de trabalho para `0.51.0` no banco de dados e atualizar usando a versão twenty `0.52.11` seguindo o guia de atualização logo acima.
### v0.50 to v0.51
### v0.50 para v0.51
Upgrade your Twenty instance to use v0.51 image
Atualize sua instância do Twenty para usar a imagem v0.51
```
yarn database:migrate:prod
yarn command:prod upgrade
```
### v0.44.0 to v0.50.0
### v0.44.0 para v0.50.0
Upgrade your Twenty instance to use v0.50.0 image
Atualize sua instância do Twenty para usar a imagem v0.50.0
```
yarn database:migrate:prod
yarn command:prod upgrade
```
#### Docker-compose.yml mutation
#### Mutação 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 versão inclui uma mutação `docker-compose.yml` para dar ao serviço `worker` acesso ao volume `server-local-data`.
Por favor, atualize seu `docker-compose.yml` local com [v0.50.0 docker-compose.yml](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 para v0.44.0
Upgrade your Twenty instance to use v0.44.0 image
Atualize sua instância do Twenty para usar a imagem v0.44.0
```
yarn database:migrate:prod
yarn command:prod upgrade
```
### v0.42.0 to v0.43.0
### v0.42.0 para v0.43.0
Upgrade your Twenty instance to use v0.43.0 image
Atualize sua instância do Twenty para usar a imagem 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.
Nesta versão, também trocamos para a imagem postgres:16 no docker-compose.yml.
#### (Option 1) Database migration
#### (Opção 1) Migração do banco de dados
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.
Manter a imagem postgres-spilo existente está ok, mas você terá que congelar a versão no seu docker-compose.yml para ser 0.43.0.
#### (Option 2) Database migration
#### (Opção 2) Migração do banco de dados
If you want to migrate your database to the new postgres:16 image, please follow these steps:
Se você quiser migrar seu banco de dados para a nova imagem postgres:16, siga estas etapas:
1. Dump your database from the old postgres-spilo container
1. Faça dump do seu banco de dados do contêiner antigo 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.
Certifique-se de que seu arquivo de dump não está vazio.
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. Atualize seu docker-compose.yml para usar a imagem postgres:16 como no arquivo [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 o banco de dados para o novo contêiner 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 para v0.42.0
Upgrade your Twenty instance to use v0.42.0 image
Atualize sua instância do Twenty para usar a imagem v0.42.0
```
yarn database:migrate:prod
yarn command:prod upgrade-0.42
```
**Environment Variables**
**Variáveis de Ambiente**
* 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`
* Removido: `FRONT_PORT`, `FRONT_PROTOCOL`, `FRONT_DOMAIN`, `PORT`
* Adicionado: `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 para v0.41.0
Upgrade your Twenty instance to use v0.41.0 image
Atualize sua instância do Twenty para usar a imagem v0.41.0
```
yarn database:migrate:prod
yarn command:prod upgrade-0.41
```
**Environment Variables**
**Variáveis de Ambiente**
* Removed: `AUTH_MICROSOFT_TENANT_ID`
* Removido: `AUTH_MICROSOFT_TENANT_ID`
### v0.35.0 to v0.40.0
### v0.35.0 para v0.40.0
Upgrade your Twenty instance to use v0.40.0 image
Atualize sua instância do Twenty para usar a imagem v0.40.0
```
yarn database:migrate:prod
yarn command:prod upgrade-0.40
```
**Environment Variables**
**Variáveis de Ambiente**
* Added: `IS_EMAIL_VERIFICATION_REQUIRED`, `EMAIL_VERIFICATION_TOKEN_EXPIRES_IN`, `WORKFLOW_EXEC_THROTTLE_LIMIT`, `WORKFLOW_EXEC_THROTTLE_TTL`
* Adicionado: `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 para v0.35.0
Upgrade your Twenty instance to use v0.35.0 image
Atualize sua instância do Twenty para usar a imagem 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.
O comando `yarn database:migrate:prod` aplicará as migrações à estrutura do banco de dados (esquemas core e metadata)
O `yarn command:prod upgrade-0.35` cuida da migração de dados de todos os espaços de trabalho.
**Environment Variables**
**Variáveis de Ambiente**
* We replaced `ENABLE_DB_MIGRATIONS` with `DISABLE_DB_MIGRATIONS` (default value is now `false`, you probably don't have to set anything)
* Substituímos `ENABLE_DB_MIGRATIONS` por `DISABLE_DB_MIGRATIONS` (o valor padrão agora é `false`, você provavelmente não precisará definir nada)
### v0.33.0 to v0.34.0
### v0.33.0 para v0.34.0
Upgrade your Twenty instance to use v0.34.0 image
Atualize sua instância do Twenty para usar a imagem 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.
O comando `yarn database:migrate:prod` aplicará as migrações à estrutura do banco de dados (esquemas core e metadata)
O `yarn command:prod upgrade-0.34` cuida da migração de dados de todos os espaços de trabalho.
**Environment Variables**
**Variáveis de Ambiente**
* Removed: `FRONT_BASE_URL`
* Added: `FRONT_DOMAIN`, `FRONT_PROTOCOL`, `FRONT_PORT`
* Removido: `FRONT_BASE_URL`
* Adicionado: `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`.
Atualizamos a forma como lidamos com a URL do frontend.
Agora você pode definir a URL do frontend usando as variáveis `FRONT_DOMAIN`, `FRONT_PROTOCOL` e `FRONT_PORT`.
Se FRONT_DOMAIN não estiver definido, a URL do frontend voltará para `SERVER_URL`.
### v0.32.0 to v0.33.0
### v0.32.0 para v0.33.0
Upgrade your Twenty instance to use v0.33.0 image
Atualize sua instância do Twenty para usar a imagem 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.
O comando `yarn command:prod cache:flush` limpará o cache do Redis.
O comando `yarn database:migrate:prod` aplicará as migrações à estrutura do banco de dados (esquemas core e metadata)
O `yarn command:prod upgrade-0.33` cuida da migração de dados de todos os espaços de trabalho.
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 desta versão, a imagem twenty-postgres para DB tornou-se obsoleta e o twenty-postgres-spilo é usado em vez disso.
Se você quiser continuar usando a imagem twenty-postgres, basta substituir `twentycrm/twenty-postgres:${TAG}` por `twentycrm/twenty-postgres` em docker-compose.yml.
### v0.31.0 to v0.32.0
### v0.31.0 para v0.32.0
Upgrade your Twenty instance to use v0.32.0 image
Atualize sua instância do Twenty para usar a imagem v0.32.0
**Schema and data migration**
**Migração de esquema e dados**
```
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.
O comando `yarn database:migrate:prod` aplicará as migrações à estrutura do banco de dados (esquemas core e metadata)
O `yarn command:prod upgrade-0.32` cuida da migração de dados de todos os espaços de trabalho.
**Environment Variables**
**Variáveis de Ambiente**
We have updated the way we handle the Redis connection.
Atualizamos a forma como lidamos com a conexão Redis.
* Removed: `REDIS_HOST`, `REDIS_PORT`, `REDIS_USERNAME`, `REDIS_PASSWORD`
* Added: `REDIS_URL`
* Removido: `REDIS_HOST`, `REDIS_PORT`, `REDIS_USERNAME`, `REDIS_PASSWORD`
* Adicionado: `REDIS_URL`
Update your `.env` file to use the new `REDIS_URL` variable instead of the individual Redis connection parameters.
Atualize seu arquivo `.env` para usar a nova variável `REDIS_URL` em vez dos parâmetros de conexão Redis individuais.
We have also simplified the way we handle the JWT tokens.
Também simplificamos a forma como lidamos com os tokens JWT.
* Removed: `ACCESS_TOKEN_SECRET`, `LOGIN_TOKEN_SECRET`, `REFRESH_TOKEN_SECRET`, `FILE_TOKEN_SECRET`
* Added: `APP_SECRET`
* Removido: `ACCESS_TOKEN_SECRET`, `LOGIN_TOKEN_SECRET`, `REFRESH_TOKEN_SECRET`, `FILE_TOKEN_SECRET`
* Adicionado: `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)
Atualize seu arquivo `.env` para usar a nova variável `APP_SECRET` em vez dos segredos dos tokens individuais (você pode usar o mesmo segredo de antes ou gerar uma nova string aleatória)
**Connected Account**
**Conta Ligada**
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.
Se você estiver usando uma conta conectada para sincronizar seus e-mails e calendários do Google, precisará ativar a [API People](https://developers.google.com/people) no console de administração do Google.
### v0.30.0 to v0.31.0
### v0.30.0 para v0.31.0
Upgrade your Twenty instance to use v0.31.0 image
Atualize sua instância do Twenty para usar a imagem v0.31.0
**Schema and data migration**:
**Migração de esquema e dados**:
```
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.
O comando `yarn database:migrate:prod` aplicará as migrações à estrutura do banco de dados (esquemas core e metadata)
O `yarn command:prod upgrade-0.31` cuida da migração de dados de todos os espaços de trabalho.
### v0.24.0 to v0.30.0
### v0.24.0 para v0.30.0
Upgrade your Twenty instance to use v0.30.0 image
Atualize sua instância do Twenty para usar a imagem 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:
**Mudança radical**:
Para melhorar o desempenho, o Twenty agora requer que o cache redis seja configurado. Atualizamos nosso [docker-compose.yml](https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/docker-compose.yml) para refletir isso.
Certifique-se de atualizar sua configuração e suas variáveis de ambiente adequadamente:
```
REDIS_HOST={your-redis-host}
@@ -326,49 +326,49 @@ REDIS_PORT={your-redis-port}
CACHE_STORAGE_TYPE=redis
```
**Schema and data migration**:
**Migração de esquema e dados**:
```
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.
O comando `yarn database:migrate:prod` aplicará as migrações à estrutura do banco de dados (esquemas core e metadata)
O `yarn command:prod upgrade-0.30` cuida da migração de dados de todos os espaços de trabalho.
### v0.23.0 to v0.24.0
### v0.23.0 para v0.24.0
Upgrade your Twenty instance to use v0.24.0 image
Atualize sua instância do Twenty para usar a imagem v0.24.0
Run the following commands:
Execute os seguintes 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.
O comando `yarn database:migrate:prod` aplicará as migrações à estrutura do banco de dados (esquemas core e metadata)
O `yarn command:prod upgrade-0.24` cuida da migração de dados de todos os espaços de trabalho.
### v0.22.0 to v0.23.0
### v0.22.0 para v0.23.0
Upgrade your Twenty instance to use v0.23.0 image
Atualize sua instância do Twenty para usar a imagem v0.23.0
Run the following commands:
Execute os seguintes 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.
O comando `yarn database:migrate:prod` aplicará as migrações ao Banco de Dados.
O `yarn command:prod upgrade-0.23` cuida da migração de dados, incluindo a transferência de atividades para tarefas/notas.
### v0.21.0 to v0.22.0
### v0.21.0 para v0.22.0
Upgrade your Twenty instance to use v0.22.0 image
Atualize sua instância do Twenty para usar a imagem v0.22.0
Run the following commands:
Execute os seguintes 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.
O comando `yarn database:migrate:prod` aplicará as migrações ao Banco de Dados.
O comando `yarn command:prod workspace:sync-metadata -f` sincronizará a definição de objetos padrão com as tabelas de metadados e aplicará as migrações necessárias aos espaços de trabalho existentes.
O comando `yarn command:prod upgrade-0.22` aplicará transformações de dados específicas para se adaptar às novas opções padrão de requestInstrumentationOptions do objeto.
@@ -1,30 +1,30 @@
---
title: Self-Host
description: Deploy and manage Twenty on your own infrastructure.
title: Auto-hospedagem
description: Implante e gerencie o Twenty na sua própria infraestrutura.
---
<Frame>
<img src="/images/user-guide/what-is-twenty/20.png" alt="AI" />
<img src="/images/user-guide/what-is-twenty/20.png" alt="IA" />
</Frame>
## Overview
## Visão geral
Twenty can be self-hosted on your own infrastructure, giving you full control over your data and deployment.
O Twenty pode ser auto-hospedado na sua própria infraestrutura, oferecendo controle total sobre seus dados e a implantação.
## Why Self-Host?
## Por que auto-hospedar?
* **Data ownership**: Keep all CRM data on your own servers
* **Compliance**: Meet regulatory requirements for data residency
* **Customization**: Full access to modify and extend the platform
* **Propriedade dos dados**: Mantenha todos os dados de CRM nos seus próprios servidores
* **Conformidade**: Atenda aos requisitos regulatórios de residência de dados
* **Personalização**: Acesso total para modificar e estender a plataforma
## Getting Started
## Primeiros passos
<CardGroup cols={2}>
<Card title="Docker Compose" icon="docker" href="/l/pt/developers/self-host/capabilities/docker-compose">
Quick setup with Docker
Configuração rápida com Docker
</Card>
<Card title="Cloud Providers" icon="cloud" href="/l/pt/developers/self-host/capabilities/cloud-providers">
Deploy on AWS, GCP, or Azure
<Card title="Provedores de nuvem" icon="cloud" href="/l/pt/developers/self-host/capabilities/cloud-providers">
Implante na AWS, GCP ou Azure
</Card>
</CardGroup>