> ## Documentation Index
> Fetch the complete documentation index at: https://help.teable.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Variabili d'ambiente
> Tutte le variabili d'ambiente disponibili in Teable e le relative spiegazioni
| Variabile d'ambiente | Descrizione | Valore predefinito | Obbligatoria | Esempio |
| --------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------ | -------------------------------------------------------------------------------------------- |
| **Configurazione principale** | | | | |
| PUBLIC\_ORIGIN | Origine pubblica per generare URL completi; deve essere impostata sull'indirizzo di accesso dell'app | - | Sì | [https://app.teable.ai](https://app.teable.ai) |
| SECRET\_KEY | Segreto radice per JWT, sessioni e condivisione. Genera un valore casuale complesso | - | Sì | `openssl rand -base64 32` |
| BACKEND\_JWT\_SECRET | Firma i JWT di autenticazione, condivisione e plugin. In sua assenza viene usato SECRET\_KEY | SECRET\_KEY | - | `openssl rand -base64 32` |
| BACKEND\_SESSION\_SECRET | Firma i cookie della sessione di accesso. In sua assenza viene usato SECRET\_KEY | SECRET\_KEY | - | `openssl rand -base64 32` |
| BACKEND\_STORAGE\_ENCRYPTION\_KEY | Crittografa i token di accesso agli allegati. Obbligatoria quando BACKEND\_STORAGE\_PROVIDER è `local` | - | Sì | stringa casuale di 16 caratteri |
| BACKEND\_STORAGE\_ENCRYPTION\_IV | Vettore di inizializzazione per la crittografia associato a BACKEND\_STORAGE\_ENCRYPTION\_KEY | - | Sì | stringa casuale di 16 caratteri |
| BACKEND\_ACCESS\_TOKEN\_ENCRYPTION\_KEY | Crittografa i token di accesso personali | - | Sì | stringa casuale di 16 caratteri |
| BACKEND\_ACCESS\_TOKEN\_ENCRYPTION\_IV | Vettore di inizializzazione per la crittografia associato a BACKEND\_ACCESS\_TOKEN\_ENCRYPTION\_KEY | - | Sì | stringa casuale di 16 caratteri |
| PORT | Porta su cui viene eseguita l'applicazione | 3000 | - | 3000 |
| LOG\_LEVEL | Livello dei log; opzioni: fatal, error, warn, info, debug, trace | info | - | debug |
| **Configurazione dello storage** | | | | |
| BACKEND\_STORAGE\_PROVIDER | Provider di storage; opzioni: local, minio, s3, aliyun | local | - | s3 |
| BACKEND\_STORAGE\_LOCAL\_PATH | Percorso dello storage locale | .assets/uploads | - | .assets/uploads |
| BACKEND\_STORAGE\_PUBLIC\_BUCKET | Nome del bucket pubblico | public | - | teable-public |
| BACKEND\_STORAGE\_PRIVATE\_BUCKET | Nome del bucket privato per allegati, file delle app, dati archiviati e altri contenuti protetti | private | - | teable-private |
| BACKEND\_STORAGE\_PUBLIC\_URL | Sostituzione dell'URL pubblico per il bucket pubblico (facoltativa) | - | - | [https://cdn.example.com](https://cdn.example.com) |
| BACKEND\_STORAGE\_PRIVATE\_BUCKET\_ENDPOINT | Sostituzione dell'endpoint del bucket privato (facoltativa) | - | - | [https://private-bucket.endpoint](https://private-bucket.endpoint) |
| BACKEND\_STORAGE\_S3\_REGION | Regione dello storage S3, obbligatoria quando BACKEND\_STORAGE\_PROVIDER è s3 | - | - | us-east-2 |
| BACKEND\_STORAGE\_S3\_ENDPOINT | Endpoint dello storage S3, obbligatorio quando BACKEND\_STORAGE\_PROVIDER è s3 | - | - | [https://s3.us-east-2.amazonaws.com](https://s3.us-east-2.amazonaws.com) |
| BACKEND\_STORAGE\_S3\_INTERNAL\_ENDPOINT | Endpoint interno S3 (facoltativo) | - | - | [http://s3.internal](http://s3.internal) |
| BACKEND\_STORAGE\_S3\_FORCE\_PATH\_STYLE | Usa URL in stile percorso (`endpoint/bucket/key`) per le richieste S3 rivolte al browser. Abilita questa opzione quando l'endpoint pubblico non può servire sottodomini dei bucket. Non può essere combinata con BACKEND\_STORAGE\_PRIVATE\_BUCKET\_ENDPOINT | false | - | true |
| BACKEND\_STORAGE\_S3\_INTERNAL\_FORCE\_PATH\_STYLE | Sostituisce l'indirizzamento in stile percorso per le richieste S3 interne. Se non impostata, eredita l'impostazione pubblica quando entrambi i client condividono un endpoint; un endpoint interno separato mantiene l'indirizzamento in stile host virtuale | - | - | true |
| BACKEND\_STORAGE\_S3\_ACCESS\_KEY | Chiave di accesso allo storage S3, obbligatoria quando BACKEND\_STORAGE\_PROVIDER è s3 | - | - | your\_access\_key |
| BACKEND\_STORAGE\_S3\_SECRET\_KEY | Chiave segreta dello storage S3, obbligatoria quando BACKEND\_STORAGE\_PROVIDER è s3 | - | - | your\_secret\_key |
| BACKEND\_STORAGE\_S3\_MAX\_SOCKETS | Numero massimo di socket S3 (facoltativo) | 100 | - | 100 |
| BACKEND\_STORAGE\_MINIO\_ENDPOINT | Endpoint dello storage MinIO | - | - | minio.example.com |
| BACKEND\_STORAGE\_MINIO\_PORT | Porta MinIO | 9000 | - | 443 |
| BACKEND\_STORAGE\_MINIO\_USE\_SSL | Indica se MinIO utilizza SSL | false | - | true |
| BACKEND\_STORAGE\_MINIO\_ACCESS\_KEY | Chiave di accesso MinIO | - | - | access-key |
| BACKEND\_STORAGE\_MINIO\_SECRET\_KEY | Chiave segreta MinIO | - | - | secret-key |
| BACKEND\_STORAGE\_MINIO\_INTERNAL\_ENDPOINT | Endpoint interno MinIO (facoltativo, senza HTTPS) | - | - | minio.internal |
| BACKEND\_STORAGE\_MINIO\_INTERNAL\_PORT | Porta interna MinIO (facoltativa) | 9000 | - | 9000 |
| BACKEND\_STORAGE\_MINIO\_REGION | Regione MinIO (facoltativa) | - | - | us-east-1 |
| BACKEND\_STORAGE\_UPLOAD\_METHOD | Metodo di caricamento | put | - | put |
| STORAGE\_PREFIX | Prefisso dello storage; il valore predefinito è PUBLIC\_ORIGIN | PUBLIC\_ORIGIN | - | [http://localhost:3000](http://localhost:3000) |
| **Configurazione della cache** | | | | |
| BACKEND\_CACHE\_PROVIDER | Provider della cache; opzioni: sqlite, memory, redis | sqlite | - | redis |
| BACKEND\_CACHE\_REDIS\_URI | URI di connessione Redis obbligatorio per la consegna delle attività calcolate; usato anche per la cache quando BACKEND\_CACHE\_PROVIDER è redis | - | Sì | redis\://default:teable\@127.0.0.1:6379/0 |
| **Configurazione della cache delle prestazioni** | | | | |
| BACKEND\_PERFORMANCE\_CACHE | URL Redis della cache delle prestazioni per memorizzare i risultati delle query e migliorare l'efficienza della collaborazione multiutente. È consigliata un'istanza Redis distinta da BACKEND\_CACHE\_REDIS\_URI | - | - | redis\://default:teable\@127.0.0.1:6379/0 |
| **Configurazione dell'autenticazione** | | | | |
| SOCIAL\_AUTH\_PROVIDERS | Elenco di provider di autenticazione social separati da virgole | - | - | github,google,oidc |
| BACKEND\_GITHUB\_CLIENT\_ID | ID client OAuth di GitHub | - | - | github\_client\_id |
| BACKEND\_GITHUB\_CLIENT\_SECRET | Segreto client OAuth di GitHub | - | - | github\_client\_secret |
| BACKEND\_GOOGLE\_CLIENT\_ID | ID client OAuth di Google | - | - | google\_client\_id |
| BACKEND\_GOOGLE\_CLIENT\_SECRET | Segreto client OAuth di Google | - | - | google\_client\_secret |
| BACKEND\_OIDC\_CLIENT\_ID | ID client OIDC | - | - | google\_client\_id |
| BACKEND\_OIDC\_CLIENT\_SECRET | Segreto client OIDC | - | - | google\_client\_secret |
| BACKEND\_OIDC\_CALLBACK\_URL | URL di callback OIDC | - | - | [https://app.teable.ai/api/auth/oidc/callback](https://app.teable.ai/api/auth/oidc/callback) |
| **Sicurezza e verifica** | | | | |
| TURNSTILE\_SITE\_KEY | Chiave del sito Cloudflare Turnstile per la verifica dell'autenticazione | - | - | 1x00000000000000000000AA |
| TURNSTILE\_SECRET\_KEY | Chiave segreta Cloudflare Turnstile per la verifica dell'autenticazione | - | - | 1x0000000000000000000000000000000AA |
| TEABLE\_SSRF\_PROTECTION\_DISABLED | Disabilita la protezione che blocca le richieste in uscita verso indirizzi di rete loopback, privati, link-local e altri indirizzi riservati. Imposta su true soltanto nei deployment self-hosted attendibili che devono accedere a endpoint interni | false | - | true |
| BACKEND\_SIGNUP\_VERIFICATION\_CODE\_RATE\_LIMIT\_SECONDS | Intervallo del limite di frequenza (secondi) per l'invio delle email con il codice di verifica della registrazione | - | - | 30 |
| BACKEND\_TRUST\_PROXY | Impostazione di attendibilità del reverse proxy usata per risolvere l'IP del client dietro un proxy. Influisce sui log di controllo e sui record di sicurezza correlati. Accetta `true`, `false`, un numero di hop o un elenco di IP/CIDR/preimpostazioni. Se vuota, considera attendibili i proxy della rete privata | loopback, linklocal, uniquelocal | - | loopback, linklocal, uniquelocal |
| **Configurazione email (deprecata: usa Amministrazione di sistema > Impostazioni istanza > Email)** | | | | |
| BACKEND\_MAIL\_HOST | Indirizzo predefinito del server di posta. Consigliamo di configurare visivamente Email di notifica ed Email di Automazione in Amministrazione di sistema > Impostazioni istanza > Email | smtp.teable.ai | - | smtp.gmail.com |
| BACKEND\_MAIL\_PORT | Porta predefinita del server di posta | 465 | - | 465 |
| BACKEND\_MAIL\_SECURE | Indica se il servizio di posta predefinito utilizza SSL/TLS | true | - | true |
| BACKEND\_MAIL\_SENDER | Indirizzo mittente predefinito | noreply.teable.ai | - | [noreply@company.com](mailto:noreply@company.com) |
| BACKEND\_MAIL\_SENDER\_NAME | Nome mittente predefinito | Teable | - | Teable |
| BACKEND\_MAIL\_AUTH\_USER | Nome utente predefinito per l'autenticazione del server di posta | - | - | username |
| BACKEND\_MAIL\_AUTH\_PASS | Password predefinita per l'autenticazione del server di posta | - | - | usertoken |
| BACKEND\_MAIL\_INVITE\_USER\_NAME\_MAX\_LENGTH | Lunghezza massima del nome dell'invitante negli oggetti delle email di invito. Un valore vuoto o 0 disabilita il troncamento | - | - | 32 |
| BACKEND\_MAIL\_INVITE\_SPACE\_NAME\_MAX\_LENGTH | Lunghezza massima del nome dello Spazio o della Base negli oggetti delle email di invito. Un valore vuoto o 0 disabilita il troncamento | - | - | 32 |
| **Configurazione sessione/JWT** | | | | |
| BACKEND\_SESSION\_EXPIRES\_IN | Durata prima della scadenza della sessione | 7d | - | 7d |
| BACKEND\_SESSION\_COOKIE\_SECURE | Indica se proteggere il cookie di sessione | false | - | true |
| BACKEND\_SESSION\_ORIGIN\_CHECK\_ENABLED | Abilita i controlli Origin e Fetch Metadata per le richieste API non sicure del browser che usano cookie di sessione. Abilita questa opzione soltanto se il reverse proxy o la CDN conserva queste intestazioni | false | - | false |
| BACKEND\_JWT\_EXPIRES\_IN | Durata prima della scadenza del JWT | 20d | - | 20d |
| BACKEND\_RESET\_PASSWORD\_EMAIL\_EXPIRES\_IN | Durata prima della scadenza dell'email di reimpostazione della password | 30m | - | 30m |
| **Limiti delle risorse** | | | | |
| MAX\_COPY\_CELLS | Numero massimo di celle copiabili in una singola richiesta | - | - | 50000 |
| MAX\_READ\_ROWS | Numero massimo di righe leggibili in una singola richiesta | - | - | 10000 |
| MAX\_ATTACHMENT\_UPLOAD\_SIZE | Dimensione massima di caricamento degli allegati (byte) | - | - | 2147483648 |
| TASK\_MAX\_FIELDS\_PER\_BATCH | Numero massimo di Campi IA inviati al modello in una richiesta batch. I valori sono limitati all'intervallo da 1 a 20 | 5 | - | 5 |
| TASK\_MAX\_CONCURRENCY | Numero massimo di esecuzioni in sospeso delle attività dei Campi IA distribuite in un ciclo di pianificazione. I valori sono limitati all'intervallo da 1 a 20 | 5 | - | 5 |
| TABLE\_LIMIT\_FIELD\_OPTIONS\_MAX\_BYTES | Numero massimo di byte per le opzioni serializzate dei Campi | 262144 | - | 262144 |
| TABLE\_LIMIT\_SELECT\_CHOICES\_MAX | Numero massimo di scelte per un Campo di selezione | 1000 | - | 1000 |
| TABLE\_LIMIT\_SELECT\_CHOICE\_NAME\_MAX\_LENGTH | Lunghezza massima del nome di una scelta di selezione | 1000 | - | 1000 |
| TABLE\_LIMIT\_SELECT\_DEFAULT\_VALUES\_MAX | Numero massimo di valori predefiniti di selezione | 100 | - | 100 |
| TABLE\_LIMIT\_CELL\_VALUE\_MAX\_BYTES | Numero massimo di byte per il valore di una cella | 262144 | - | 262144 |
| TABLE\_LIMIT\_RECORD\_FIELDS\_MAX\_BYTES | Numero massimo di byte per i Campi serializzati di un Record | 1048576 | - | 1048576 |
| TABLE\_LIMIT\_RECORDS\_PER\_MUTATION\_MAX | Numero massimo di Record per mutazione | 20000 | - | 20000 |
| TABLE\_LIMIT\_COMPUTED\_CELL\_VALUE\_MAX\_BYTES | Numero massimo di byte per il valore calcolato di una cella | 262144 | - | 262144 |
| TABLE\_LIMIT\_FORMULA\_MAX\_LENGTH | Lunghezza massima di una formula | 8192 | - | 8192 |
| TABLE\_LIMIT\_TABLES\_PER\_BASE\_MAX | Numero massimo di Tabelle per Base | 1000 | - | 1000 |
| TABLE\_LIMIT\_FIELDS\_PER\_TABLE\_MAX | Numero massimo di Campi per Tabella | 500 | - | 500 |
| TABLE\_LIMIT\_VIEWS\_PER\_TABLE\_MAX | Numero massimo di Viste per Tabella | 100 | - | 100 |
| TABLE\_LIMIT\_CREATE\_TABLE\_FIELDS\_MAX | Numero massimo di Campi accettati durante la creazione di una Tabella | 1000 | - | 1000 |
| TABLE\_LIMIT\_CREATE\_TABLE\_VIEWS\_MAX | Numero massimo di Viste accettate durante la creazione di una Tabella | 20 | - | 20 |
| TABLE\_LIMIT\_CREATE\_TABLE\_RECORDS\_MAX | Numero massimo di Record accettati durante la creazione di una Tabella | 20000 | - | 20000 |
| TABLE\_LIMIT\_RECORDS\_PER\_TABLE\_MAX | Numero massimo di righe per Tabella. Un valore vuoto indica che non esiste un limite di righe a livello di istanza | - | - | 1000000 |
| TABLE\_LIMIT\_VIEW\_FILTER\_ITEMS\_MAX | Numero massimo di elementi di filtro in una Vista | 100 | - | 100 |
| TABLE\_LIMIT\_VIEW\_FILTER\_DEPTH\_MAX | Profondità massima dei filtri annidati in una Vista | 5 | - | 5 |
| TABLE\_LIMIT\_VIEW\_SORT\_ITEMS\_MAX | Numero massimo di elementi di ordinamento in una Vista | 20 | - | 20 |
| TABLE\_LIMIT\_VIEW\_GROUP\_ITEMS\_MAX | Numero massimo di elementi di raggruppamento in una Vista | 3 | - | 3 |
| TABLE\_LIMIT\_VIEW\_OPTIONS\_MAX\_BYTES | Numero massimo di byte per le opzioni serializzate di una Vista | 262144 | - | 262144 |
| TABLE\_LIMIT\_NAME\_MAX\_LENGTH | Lunghezza massima del nome visualizzato per gli oggetti di Tabella supportati | 100 | - | 100 |
| TABLE\_LIMIT\_DESCRIPTION\_MAX\_LENGTH | Lunghezza massima della descrizione per gli oggetti di Tabella supportati | 2000 | - | 2000 |
| AUTOMATION\_MIN\_SCHEDULED\_MINUTES\_INTERVAL | Intervallo minimo (in minuti) utilizzabile da un trigger pianificato con frequenza Minuti. Imposta un valore superiore a 60 per disabilitare le pianificazioni a livello di minuti | 10 | - | 15 |
| AUTOMATION\_MIN\_EMAIL\_POLL\_INTERVAL\_MINUTES | Intervallo minimo di polling della casella di posta (in minuti) utilizzabile da un trigger email | 10 | - | 15 |
| **IA e App Builder (connessione al piano di runtime)** | | | | |
| SANDBOX\_PROVIDER | Provider di sandbox per le sessioni IA; `opensandbox` si collega a un piano di runtime self-hosted | - | - | opensandbox |
| TEABLE\_INFRA\_API\_URL | URL di ingresso del piano di runtime: deve essere l'ingresso pubblico (instrada `/v1` al motore sandbox), non l'indirizzo di un servizio interno | - | - | [https://infra.teable.example.com](https://infra.teable.example.com) |
| TEABLE\_INFRA\_API\_KEY | Chiave API condivisa con il piano di runtime | - | - | your-infra-api-key |
| TEABLE\_INFRA\_BUCKET | Bucket per il piano dati dell'area di lavoro IA | teable-agent | - | teable-agent |
| SANDBOX\_OPENSANDBOX\_IMAGE | **Prefisso senza tag** dell'immagine dell'agente sandbox: Teable aggiunge il proprio tag di release affinché l'agente corrisponda sempre alla versione dell'app. I deployment in Cina usano il prefisso del mirror Aliyun | - | - | ghcr.io/teableio/teable-sandbox-agent |
| SANDBOX\_OPENSANDBOX\_RUNTIME | Tipo di runtime del motore sandbox: `kubernetes` o `docker`. Nei deployment Docker deve essere `docker` | kubernetes | - | docker |
| SANDBOX\_OPENSANDBOX\_USE\_SERVER\_PROXY | Instrada gli endpoint sandbox attraverso il proxy basato su percorso del motore anziché tramite sottodomini per porta (utilizzato dalla modalità locale di Docker) | false | - | true |
| APP\_DEPLOY\_PROVIDER | Backend di deployment di App Builder; l'hosting autonomo completo usa `docker-runtime` | vercel | - | docker-runtime |
| SANDBOX\_JWT\_SECRET | Segreto per firmare le sessioni sandbox. Genera un valore casuale per ogni host e usa lo stesso valore nel servizio sandbox | - | Sì | stringa casuale |
| SANDBOX\_CPU | vCPU per sandbox (le impostazioni dell'Amministrazione di sistema hanno la precedenza) | 2 | - | 2 |
| SANDBOX\_MEMORY | Memoria (GiB) per sandbox (le impostazioni dell'Amministrazione di sistema hanno la precedenza) | 4 | - | 4 |
| SANDBOX\_DISK | Disco temporaneo (GiB) per sandbox (le impostazioni dell'Amministrazione di sistema hanno la precedenza) | 15 | - | 15 |
| **Opzioni delle funzionalità** | | | | |
| RECORD\_HISTORY\_DISABLED | Indica se disabilitare la cronologia dei Record; il valore predefinito è false | false | - | true |
| BACKEND\_STORAGE\_COLD\_ARCHIVE\_DISABLED | Indica se interrompere l'archiviazione pianificata dei dati storici. I dati già archiviati rimangono leggibili | false | - | true |
| PASSWORD\_LOGIN\_DISABLED | Indica se disabilitare l'accesso con password (OAuth e OIDC restano disponibili) | false | - | true |
| **Analisi e monitoraggio** | | | | |
| MICROSOFT\_CLARITY\_ID | ID delle metriche di Microsoft Clarity, per abilitare l'analisi con Microsoft Clarity | - | - | your-metrics-id |
| OTEL\_EXPORTER\_OTLP\_ENDPOINT | Endpoint OTLP di OpenTelemetry | - | - | [http://jaeger:4317](http://jaeger:4317) |
| TELEMETRY\_REPORT\_DISABLED | Disabilita l'invio della telemetria self-hosted, inclusi i report di conformità delle licenze provenienti dalle istanze connesse | false | - | true |
| **Configurazione del database** | | | | |
| PRISMA\_DATABASE\_URL | URL di connessione al database; deve essere configurato | - | Sì | postgresql://teable:teable\@127.0.0.1:5432/teable |
| PUBLIC\_DATABASE\_PROXY | Indirizzo del database raggiungibile dall'esterno (host:porta) usato nelle credenziali generate dal pannello "Connessione database" della Base; impostalo per abilitare l'accesso SQL esterno in sola lettura | - | - | db.example.com:42345 |
| PRISMA\_TRANSACTION\_TIMEOUT | Durata massima (ms) di una transazione prima del timeout. Aumentala per le transazioni prolungate (ad esempio, aggiornamenti in blocco con molte chiavi esterne) | 5000 | - | 60000 |
| PRISMA\_TRANSACTION\_MAX\_WAIT | Tempo massimo (ms) di attesa per acquisire una transazione dal pool | 2000 | - | 5000 |
| BIG\_TRANSACTION\_TIMEOUT | Timeout (ms) per le transazioni interne di grandi dimensioni, come l'esportazione di Base di grandi dimensioni | 600000 | - | 1200000 |
Segreti e rotazione
Ogni valore indicato sopra come segreto deve provenire dalla tua configurazione.
Il server li controlla una volta all'avvio, ma un segreto mancante non impedisce mai
l'avvio: Teable utilizza il valore predefinito incorporato nelle versioni precedenti,
registra le variabili mancanti nei log e si avvia. Questi valori incorporati sono
pubblici, quindi chiunque può falsificare token o decifrare i dati che proteggono.
Ciò è accettabile per una rapida prova locale, ma non è sicuro in altri contesti.
**Aggiornamento di un deployment esistente.** Un'istanza eseguita senza queste
variabili utilizzava implicitamente i vecchi valori incorporati e continua a usarli.
L'avviso all'avvio mostra il blocco esatto da aggiungere affinché sessioni, token e
dati crittografati esistenti continuino a funzionare. Copialo così com'è, riavvia,
quindi pianifica una rotazione. Se il formato della configurazione lo richiede,
ricorda di eseguire l'escape di `$` nei valori.
**Nuovo deployment.** Genera invece valori nuovi:
```bash theme={null}
openssl rand -base64 32
```
Usa `openssl rand -hex 8` per gli slot `*_ENCRYPTION_KEY` e
`*_ENCRYPTION_IV` di 16 caratteri.
Il log di avvio mostra un avviso anche quando un segreto è impostato esplicitamente
su un vecchio valore predefinito noto pubblicamente. L'istanza continua a funzionare
affinché i dati restino accessibili, ma chiunque può falsificare token o decifrare i
dati protetti da tale valore. Esegui la rotazione.