Vai al contenuto principale
Header
Docker containers are for production hosting or self-hosting, for the contribution please check the Local Setup.

​
Panoramica

Questa guida fornisce istruzioni passo passo per installare e configurare l’applicazione Twenty usando Docker Compose. L’obiettivo è rendere il processo semplice ed evitare gli errori comuni che potrebbero compromettere il tuo setup. Importante: Modifica solo le impostazioni esplicitamente menzionate in questa guida. Modificare altre configurazioni potrebbe portare a problemi. Consulta i documenti Configurazione delle Variabili di Ambiente per configurazioni avanzate. Tutte le variabili di ambiente devono essere dichiarate nel file docker-compose.yml a livello di server e/o di worker a seconda della variabile.

​
Requisiti di Sistema

  • RAM: Assicurati che il tuo ambiente abbia almeno 2GB di RAM. Memoria insufficiente può causare arresti anomali dei processi.
  • Docker & Docker Compose: Assicurati che entrambi siano installati e aggiornati.

​
Opzione 1: Script a riga singola

Installa l’ultima versione stabile di Twenty con un unico comando: 
bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)
Per installare una versione o un ramo specifico: 
VERSION=vx.y.z BRANCH=branch-name bash <(curl -sL https://raw.githubusercontent.com/twentyhq/twenty/main/packages/twenty-docker/scripts/install.sh)
  • Sostituisci x.y.z con il numero di versione desiderato.
  • Sostituisci nome-ramo con il nome del ramo che vuoi installare.

​
Opzione 2: Passaggi manuali

Segui questi passaggi per un setup manuale.

​
Passo 1: Configura il File di Ambiente

  1. Crea il File .env Copia il file di ambiente di esempio in un nuovo file .env nella tua directory di lavoro: 
    curl -o .env https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/.env.example
  2. Genera Token Segreti Esegui il seguente comando per generare una stringa casuale unica: 
    openssl rand -base64 32
    Importante: Tieni questo valore segreto / non condividerlo.
  3. Aggiorna il .env Sostituisci il valore segnaposto nel tuo file .env con il token generato: 
    APP_SECRET=first_random_string
  4. Imposta la Password di Postgres Aggiorna il valore PG_DATABASE_PASSWORD nel file .env con una password forte senza caratteri speciali. 
    PG_DATABASE_PASSWORD=my_strong_password

​
Passo 2: Ottieni il File Docker Compose

Scarica il file docker-compose.yml nella tua directory di lavoro: 
curl -o docker-compose.yml https://raw.githubusercontent.com/twentyhq/twenty/refs/heads/main/packages/twenty-docker/docker-compose.yml

​
Passo 3: Avvia l’Applicazione

Avvia i container Docker: 
docker compose up -d

​
Passo 4: Accedi all’Applicazione

Se ospiti twentyCRM sul tuo computer, apri il browser e naviga a http://localhost:3000. Se lo ospiti su un server, controlla che il server sia in esecuzione e che tutto sia ok con 
curl http://localhost:3000

​
Configurazione

​
Esponi Twenty per Accesso Esterno

Per impostazione predefinita, Twenty gira su localhost alla porta 3000. Per accedervi tramite un dominio esterno o indirizzo IP devi configurare il SERVER_URL nel tuo file .env.

​
Comprendere SERVER_URL

  • Protocollo: Usa http o https a seconda della tua configurazione.
    • Usa http se non hai configurato SSL.
    • Usa https se hai configurato SSL.
  • Dominio/IP: Questo è il nome del dominio o indirizzo IP dove la tua applicazione è accessibile.
  • Porta: Includi il numero di porta se non stai usando le porte predefinite (80 per http, 443 per https).

​
Requisiti SSL

SSL (HTTPS) è necessario affinché alcune caratteristiche del browser funzionino correttamente. Mentre queste caratteristiche potrebbero funzionare durante lo sviluppo locale (poiché i browser trattano localhost in modo diverso), è necessario un setup SSL adeguato quando si ospita Twenty su un dominio regolare. Ad esempio, l’API degli appunti potrebbe richiedere un contesto sicuro - alcune funzionalità come i pulsanti di copia in tutta l’applicazione potrebbero non funzionare senza HTTPS abilitato. Raccomandiamo fortemente di configurare Twenty dietro un proxy inverso con terminazione SSL per una sicurezza e funzionalità ottimali.

​
Configurare SERVER_URL

  1. Determina il tuo URL di Accesso
    • Senza Proxy Inverso (Accesso Diretto): Se accedi all’applicazione direttamente senza un proxy inverso: 
      SERVER_URL=http://your-domain-or-ip:3000
    • Con Proxy Inverso (Porte Standard): Se usi un proxy inverso come Nginx o Traefik e hai configurato SSL: 
      SERVER_URL=https://your-domain-or-ip
    • Con Proxy Inverso (Porte Personalizzate): Se usi porte non standard: 
      SERVER_URL=https://your-domain-or-ip:custom-port
  2. Aggiorna il File .env Apri il tuo file .env e aggiorna il SERVER_URL: 
    SERVER_URL=http(s)://your-domain-or-ip:your-port
    Esempi:
    • Accesso diretto senza SSL: 
      SERVER_URL=http://123.45.67.89:3000
    • Accesso tramite dominio con SSL: 
      SERVER_URL=https://mytwentyapp.com
  3. Riavvia l’Applicazione Per rendere effettive le modifiche, riavvia i container Docker: 
    docker compose down
docker compose up -d

​
Considerazioni

  • Configurazione del Reverse Proxy: Assicurati che il tuo reverse proxy inoltri le richieste alla porta interna corretta (3000 per impostazione predefinita). Configura la terminazione SSL e tutte le intestazioni necessarie.
  • Impostazioni Firewall: Apri le porte necessarie nel tuo firewall per consentire l’accesso esterno.
  • Coerenza: Il SERVER_URL deve corrispondere a come gli utenti accedono alla tua applicazione nei loro browser.

​
Persistenza

  • Volumi di Dati: La configurazione di Docker Compose utilizza volumi per mantenere i dati per il database e l’archiviazione del server.
  • Ambienti Senza Stato: Se si distribuisce in un ambiente senza stato (ad esempio, alcuni servizi di cloud), configura l’archiviazione esterna per mantenere i dati.

​
Risoluzione dei problemi

Se riscontri problemi, controlla Risoluzione dei problemi per le soluzioni.