| Variable d’environnement | Description | Valeur par défaut | Obligatoire | Exemple |
|---|---|---|---|---|
| Configuration principale | ||||
| PUBLIC_ORIGIN | Origine publique servant à générer des URL complètes ; doit être définie sur l’adresse d’accès de votre application | - | Oui | https://app.teable.ai |
| SECRET_KEY | Secret racine pour les JWT, les sessions et le partage. Générez une valeur aléatoire robuste | - | Oui | openssl rand -base64 32 |
| BACKEND_JWT_SECRET | Signe les JWT d’authentification, de partage et de plugin. Utilise SECRET_KEY par défaut | SECRET_KEY | - | openssl rand -base64 32 |
| BACKEND_SESSION_SECRET | Signe les cookies de session de connexion. Utilise SECRET_KEY par défaut | SECRET_KEY | - | openssl rand -base64 32 |
| BACKEND_STORAGE_ENCRYPTION_KEY | Chiffre les jetons d’accès aux pièces jointes. Obligatoire lorsque BACKEND_STORAGE_PROVIDER est local | - | Oui | Chaîne aléatoire de 16 caractères |
| BACKEND_STORAGE_ENCRYPTION_IV | Vecteur d’initialisation de chiffrement associé à BACKEND_STORAGE_ENCRYPTION_KEY | - | Oui | Chaîne aléatoire de 16 caractères |
| BACKEND_ACCESS_TOKEN_ENCRYPTION_KEY | Chiffre les jetons d’accès personnels | - | Oui | Chaîne aléatoire de 16 caractères |
| BACKEND_ACCESS_TOKEN_ENCRYPTION_IV | Vecteur d’initialisation de chiffrement associé à BACKEND_ACCESS_TOKEN_ENCRYPTION_KEY | - | Oui | Chaîne aléatoire de 16 caractères |
| PORT | Port sur lequel l’application s’exécute | 3000 | - | 3000 |
| LOG_LEVEL | Niveau de journalisation, options : fatal, error, warn, info, debug, trace | info | - | debug |
| Configuration du stockage | ||||
| BACKEND_STORAGE_PROVIDER | Fournisseur de stockage, options : local, minio, s3, aliyun | local | - | s3 |
| BACKEND_STORAGE_LOCAL_PATH | Chemin de stockage local | .assets/uploads | - | .assets/uploads |
| BACKEND_STORAGE_PUBLIC_BUCKET | Nom du bucket public | public | - | teable-public |
| BACKEND_STORAGE_PRIVATE_BUCKET | Nom du bucket privé pour les pièces jointes, les fichiers d’application, les données archivées et les autres contenus protégés | private | - | teable-private |
| BACKEND_STORAGE_PUBLIC_URL | Remplacement facultatif de l’URL publique du bucket public | - | - | https://cdn.example.com |
| BACKEND_STORAGE_PRIVATE_BUCKET_ENDPOINT | Remplacement facultatif du point de terminaison du bucket privé | - | - | https://private-bucket.endpoint |
| BACKEND_STORAGE_S3_REGION | Région de stockage S3, requise lorsque BACKEND_STORAGE_PROVIDER est s3 | - | - | us-east-2 |
| BACKEND_STORAGE_S3_ENDPOINT | Point de terminaison de stockage S3, requis lorsque BACKEND_STORAGE_PROVIDER est s3 | - | - | https://s3.us-east-2.amazonaws.com |
| BACKEND_STORAGE_S3_INTERNAL_ENDPOINT | Point de terminaison interne S3 (facultatif) | - | - | http://s3.internal |
| BACKEND_STORAGE_S3_FORCE_PATH_STYLE | Utiliser des URL de style chemin (endpoint/bucket/key) pour les requêtes S3 destinées au navigateur. Activez cette option lorsque le point de terminaison public ne peut pas servir les sous-domaines de bucket. Ne peut pas être combiné avec BACKEND_STORAGE_PRIVATE_BUCKET_ENDPOINT | false | - | true |
| BACKEND_STORAGE_S3_INTERNAL_FORCE_PATH_STYLE | Remplacer l’adressage de style chemin pour les requêtes S3 internes. Lorsqu’il n’est pas défini, il hérite du paramètre public si les deux clients partagent un point de terminaison ; un point de terminaison interne distinct conserve l’adressage à hôte virtuel | - | - | true |
| BACKEND_STORAGE_S3_ACCESS_KEY | Clé d’accès au stockage S3, requise lorsque BACKEND_STORAGE_PROVIDER est s3 | - | - | your_access_key |
| BACKEND_STORAGE_S3_SECRET_KEY | Clé secrète du stockage S3, requise lorsque BACKEND_STORAGE_PROVIDER est s3 | - | - | your_secret_key |
| BACKEND_STORAGE_S3_MAX_SOCKETS | Nombre maximal de sockets S3 (facultatif) | 100 | - | 100 |
| BACKEND_STORAGE_MINIO_ENDPOINT | Point de terminaison de stockage MinIO | - | - | minio.example.com |
| BACKEND_STORAGE_MINIO_PORT | Port MinIO | 9000 | - | 443 |
| BACKEND_STORAGE_MINIO_USE_SSL | Indique si MinIO utilise SSL | false | - | true |
| BACKEND_STORAGE_MINIO_ACCESS_KEY | Clé d’accès MinIO | - | - | access-key |
| BACKEND_STORAGE_MINIO_SECRET_KEY | Clé secrète MinIO | - | - | secret-key |
| BACKEND_STORAGE_MINIO_INTERNAL_ENDPOINT | Point de terminaison interne MinIO (facultatif, sans HTTPS) | - | - | minio.internal |
| BACKEND_STORAGE_MINIO_INTERNAL_PORT | Port interne MinIO (facultatif) | 9000 | - | 9000 |
| BACKEND_STORAGE_MINIO_REGION | Région MinIO (facultatif) | - | - | us-east-1 |
| BACKEND_STORAGE_UPLOAD_METHOD | Méthode de téléversement | put | - | put |
| STORAGE_PREFIX | Préfixe de stockage ; utilise PUBLIC_ORIGIN par défaut | PUBLIC_ORIGIN | - | http://localhost:3000 |
| Configuration du cache | ||||
| BACKEND_CACHE_PROVIDER | Fournisseur de cache, options : sqlite, memory, redis | sqlite | - | redis |
| BACKEND_CACHE_REDIS_URI | URI de connexion Redis requise pour la livraison des tâches calculées ; également utilisée pour le cache lorsque BACKEND_CACHE_PROVIDER est redis | - | Oui | redis://default:teable@127.0.0.1:6379/0 |
| Configuration du cache de performances | ||||
| BACKEND_PERFORMANCE_CACHE | URL Redis de cache des performances pour la mise en cache des résultats de requête ; améliore l’efficacité de la collaboration multi-utilisateur. Il est recommandé d’utiliser une instance Redis distincte de BACKEND_CACHE_REDIS_URI | - | - | redis://default:teable@127.0.0.1:6379/0 |
| Configuration de l’authentification | ||||
| SOCIAL_AUTH_PROVIDERS | Liste des fournisseurs d’authentification sociale, séparés par des virgules | - | - | github,google,oidc |
| BACKEND_GITHUB_CLIENT_ID | ID client OAuth GitHub | - | - | github_client_id |
| BACKEND_GITHUB_CLIENT_SECRET | Secret client OAuth GitHub | - | - | github_client_secret |
| BACKEND_GOOGLE_CLIENT_ID | ID client OAuth Google | - | - | google_client_id |
| BACKEND_GOOGLE_CLIENT_SECRET | Secret client OAuth Google | - | - | google_client_secret |
| BACKEND_OIDC_CLIENT_ID | ID client OIDC | - | - | google_client_id |
| BACKEND_OIDC_CLIENT_SECRET | Secret client OIDC | - | - | google_client_secret |
| BACKEND_OIDC_CALLBACK_URL | URL de rappel OIDC | - | - | https://app.teable.ai/api/auth/oidc/callback |
| Sécurité et vérification | ||||
| TURNSTILE_SITE_KEY | Clé de site Cloudflare Turnstile pour la vérification de l’authentification | - | - | 1x00000000000000000000AA |
| TURNSTILE_SECRET_KEY | Clé secrète Cloudflare Turnstile pour la vérification de l’authentification | - | - | 1x0000000000000000000000000000000AA |
| TEABLE_SSRF_PROTECTION_DISABLED | Désactive la protection qui bloque les requêtes sortantes vers les adresses réseau loopback, privées, link-local et autres adresses réservées. Définissez cette valeur sur true uniquement dans les déploiements Auto-hébergé de confiance qui doivent accéder à des points de terminaison internes | false | - | true |
| BACKEND_SIGNUP_VERIFICATION_CODE_RATE_LIMIT_SECONDS | Intervalle de limitation (secondes) pour l’envoi des e-mails de vérification d’inscription | - | - | 30 |
| BACKEND_TRUST_PROXY | Paramètre de confiance du proxy inverse utilisé pour résoudre l’IP client derrière un proxy. Affecte les journaux d’audit et les enregistrements de sécurité associés. Accepte true, false, un nombre de sauts ou une liste d’IP/CIDR/préréglages. Une valeur vide fait confiance aux proxys de réseau privé | loopback, linklocal, uniquelocal | - | loopback, linklocal, uniquelocal |
| Configuration des e-mails (obsolète — utilisez Administration système > Paramètres de l’instance > E-mail) | ||||
| BACKEND_MAIL_HOST | Adresse du serveur de messagerie par défaut. Nous recommandons de configurer visuellement les e-mails de notification et d’automatisation dans Administration système > Paramètres de l’instance > E-mail | smtp.teable.ai | - | smtp.gmail.com |
| BACKEND_MAIL_PORT | Port du serveur de messagerie par défaut | 465 | - | 465 |
| BACKEND_MAIL_SECURE | Indique si le service de messagerie par défaut utilise SSL/TLS | true | - | true |
| BACKEND_MAIL_SENDER | Adresse d’expéditeur par défaut | noreply.teable.ai | - | noreply@company.com |
| BACKEND_MAIL_SENDER_NAME | Nom d’expéditeur par défaut | Teable | - | Teable |
| BACKEND_MAIL_AUTH_USER | Nom d’utilisateur d’authentification du serveur de messagerie par défaut | - | - | username |
| BACKEND_MAIL_AUTH_PASS | Mot de passe d’authentification du serveur de messagerie par défaut | - | - | usertoken |
| BACKEND_MAIL_INVITE_USER_NAME_MAX_LENGTH | Longueur maximale du nom de l’invitant dans les objets des e-mails d’invitation. Une valeur vide ou 0 désactive la troncature | - | - | 32 |
| BACKEND_MAIL_INVITE_SPACE_NAME_MAX_LENGTH | Longueur maximale du nom de l’Espace ou de la Base dans les objets des e-mails d’invitation. Une valeur vide ou 0 désactive la troncature | - | - | 32 |
| Configuration Session/JWT | ||||
| BACKEND_SESSION_EXPIRES_IN | Durée d’expiration de la session | 7d | - | 7d |
| BACKEND_SESSION_COOKIE_SECURE | Indique si le cookie de session doit être sécurisé | false | - | true |
| BACKEND_SESSION_ORIGIN_CHECK_ENABLED | Active les vérifications Origin et Fetch Metadata pour les requêtes d’API non sûres du navigateur utilisant des cookies de session. Activez cette option uniquement lorsque votre proxy inverse ou CDN préserve ces en-têtes | false | - | false |
| BACKEND_JWT_EXPIRES_IN | Durée d’expiration du JWT | 20d | - | 20d |
| BACKEND_RESET_PASSWORD_EMAIL_EXPIRES_IN | Durée d’expiration de l’e-mail de réinitialisation du mot de passe | 30m | - | 30m |
| Limites de ressources | ||||
| MAX_COPY_CELLS | Nombre maximal de cellules à copier dans une seule requête | - | - | 50000 |
| MAX_READ_ROWS | Nombre maximal de lignes à lire dans une seule requête | - | - | 10000 |
| MAX_ATTACHMENT_UPLOAD_SIZE | Taille maximale de téléversement des pièces jointes (octets) | - | - | 2147483648 |
| TASK_MAX_FIELDS_PER_BATCH | Nombre maximal de Champs IA envoyés au modèle dans une requête par lot. Les valeurs sont limitées de 1 à 20 | 5 | - | 5 |
| TASK_MAX_CONCURRENCY | Nombre maximal d’exécutions de tâches de Champs IA en attente distribuées dans un cycle de planification. Les valeurs sont limitées de 1 à 20 | 5 | - | 5 |
| TABLE_LIMIT_FIELD_OPTIONS_MAX_BYTES | Nombre maximal d’octets sérialisés d’options de Champ | 262144 | - | 262144 |
| TABLE_LIMIT_SELECT_CHOICES_MAX | Nombre maximal de choix par Champ de sélection | 1000 | - | 1000 |
| TABLE_LIMIT_SELECT_CHOICE_NAME_MAX_LENGTH | Longueur maximale du nom d’un choix de sélection | 1000 | - | 1000 |
| TABLE_LIMIT_SELECT_DEFAULT_VALUES_MAX | Nombre maximal de valeurs par défaut de sélection | 100 | - | 100 |
| TABLE_LIMIT_CELL_VALUE_MAX_BYTES | Nombre maximal d’octets de valeur de cellule | 262144 | - | 262144 |
| TABLE_LIMIT_RECORD_FIELDS_MAX_BYTES | Nombre maximal d’octets sérialisés de Champs d’Enregistrement | 1048576 | - | 1048576 |
| TABLE_LIMIT_RECORDS_PER_MUTATION_MAX | Nombre maximal d’Enregistrements par mutation | 20000 | - | 20000 |
| TABLE_LIMIT_COMPUTED_CELL_VALUE_MAX_BYTES | Nombre maximal d’octets de valeur de cellule calculée | 262144 | - | 262144 |
| TABLE_LIMIT_FORMULA_MAX_LENGTH | Longueur maximale de formule | 8192 | - | 8192 |
| TABLE_LIMIT_TABLES_PER_BASE_MAX | Nombre maximal de Tables par Base | 1000 | - | 1000 |
| TABLE_LIMIT_FIELDS_PER_TABLE_MAX | Nombre maximal de Champs par Table | 500 | - | 500 |
| TABLE_LIMIT_VIEWS_PER_TABLE_MAX | Nombre maximal de Vues par Table | 100 | - | 100 |
| TABLE_LIMIT_CREATE_TABLE_FIELDS_MAX | Nombre maximal de Champs acceptés lors de la création d’une Table | 1000 | - | 1000 |
| TABLE_LIMIT_CREATE_TABLE_VIEWS_MAX | Nombre maximal de Vues acceptées lors de la création d’une Table | 20 | - | 20 |
| TABLE_LIMIT_CREATE_TABLE_RECORDS_MAX | Nombre maximal d’Enregistrements acceptés lors de la création d’une Table | 20000 | - | 20000 |
| TABLE_LIMIT_RECORDS_PER_TABLE_MAX | Nombre maximal de lignes par Table. Une valeur vide signifie qu’il n’y a aucune limite de lignes au niveau de l’instance | - | - | 1000000 |
| TABLE_LIMIT_VIEW_FILTER_ITEMS_MAX | Nombre maximal d’éléments de filtre dans une Vue | 100 | - | 100 |
| TABLE_LIMIT_VIEW_FILTER_DEPTH_MAX | Profondeur maximale d’imbrication des filtres dans une Vue | 5 | - | 5 |
| TABLE_LIMIT_VIEW_SORT_ITEMS_MAX | Nombre maximal d’éléments de tri dans une Vue | 20 | - | 20 |
| TABLE_LIMIT_VIEW_GROUP_ITEMS_MAX | Nombre maximal d’éléments de groupe dans une Vue | 3 | - | 3 |
| TABLE_LIMIT_VIEW_OPTIONS_MAX_BYTES | Nombre maximal d’octets sérialisés d’options de Vue | 262144 | - | 262144 |
| TABLE_LIMIT_NAME_MAX_LENGTH | Longueur maximale du nom d’affichage des objets de Table pris en charge | 100 | - | 100 |
| TABLE_LIMIT_DESCRIPTION_MAX_LENGTH | Longueur maximale de la description des objets de Table pris en charge | 2000 | - | 2000 |
| AUTOMATION_MIN_SCHEDULED_MINUTES_INTERVAL | Intervalle le plus court (minutes) qu’un déclencheur planifié peut utiliser avec la fréquence Minutes. Définissez une valeur supérieure à 60 pour désactiver les planifications à la minute | 10 | - | 15 |
| AUTOMATION_MIN_EMAIL_POLL_INTERVAL_MINUTES | Intervalle d’interrogation de boîte aux lettres le plus court (minutes) qu’un déclencheur d’e-mail peut utiliser | 10 | - | 15 |
| IA et App Builder (connexion au plan d’exécution) | ||||
| SANDBOX_PROVIDER | Fournisseur de sandbox pour les sessions IA ; opensandbox se connecte à un plan d’exécution Auto-hébergé | - | - | opensandbox |
| TEABLE_INFRA_API_URL | URL d’entrée du plan d’exécution — doit être l’entrée publique (elle achemine /v1 vers le moteur sandbox), et non une adresse de service interne | - | - | https://infra.teable.example.com |
| TEABLE_INFRA_API_KEY | Clé d’API partagée avec le plan d’exécution | - | - | your-infra-api-key |
| TEABLE_INFRA_BUCKET | Bucket pour le plan de données de l’espace de travail IA | teable-agent | - | teable-agent |
| SANDBOX_OPENSANDBOX_IMAGE | Préfixe d’image de l’agent sandbox sans balise — Teable ajoute sa propre balise de version afin que l’agent corresponde toujours à la version de l’application. Les déploiements en Chine utilisent le préfixe du miroir Aliyun | - | - | ghcr.io/teableio/teable-sandbox-agent |
| SANDBOX_OPENSANDBOX_RUNTIME | Type d’exécution du moteur sandbox : kubernetes ou docker. Doit être docker pour les déploiements Docker | kubernetes | - | docker |
| SANDBOX_OPENSANDBOX_USE_SERVER_PROXY | Achemine les points de terminaison sandbox via le proxy basé sur le chemin du moteur au lieu de sous-domaines par port (utilisé par le mode local Docker) | false | - | true |
| APP_DEPLOY_PROVIDER | Backend de déploiement App Builder ; l’auto-hébergement complet utilise docker-runtime | vercel | - | docker-runtime |
| SANDBOX_JWT_SECRET | Secret qui signe les sessions sandbox. Générez une valeur aléatoire par hôte et utilisez la même valeur dans le service sandbox | - | Oui | chaîne aléatoire |
| SANDBOX_CPU | vCPU par sandbox (les paramètres du panneau d’administration prévalent) | 2 | - | 2 |
| SANDBOX_MEMORY | Mémoire (Gio) par sandbox (les paramètres du panneau d’administration prévalent) | 4 | - | 4 |
| SANDBOX_DISK | Disque éphémère (Gio) par sandbox (les paramètres du panneau d’administration prévalent) | 15 | - | 15 |
| Basculements de fonctionnalités | ||||
| RECORD_HISTORY_DISABLED | Indique s’il faut désactiver l’historique des Enregistrements ; false par défaut | false | - | true |
| BACKEND_STORAGE_COLD_ARCHIVE_DISABLED | Indique s’il faut arrêter l’archivage planifié des données historiques. Les données déjà archivées restent lisibles | false | - | true |
| PASSWORD_LOGIN_DISABLED | Indique s’il faut désactiver la connexion par mot de passe (OAuth et OIDC restent disponibles) | false | - | true |
| Analytique et surveillance | ||||
| MICROSOFT_CLARITY_ID | ID de métriques Microsoft Clarity, pour activer l’analytique Microsoft Clarity | - | - | your-metrics-id |
| OTEL_EXPORTER_OTLP_ENDPOINT | Point de terminaison OpenTelemetry OTLP | - | - | http://jaeger:4317 |
| TELEMETRY_REPORT_DISABLED | Désactive les rapports de télémétrie Auto-hébergé, y compris les rapports de conformité des licences des instances connectées | false | - | true |
| Configuration de la base de données | ||||
| PRISMA_DATABASE_URL | URL de connexion à la base de données, doit être configurée | - | Oui | postgresql://teable:teable@127.0.0.1:5432/teable |
| PUBLIC_DATABASE_PROXY | Adresse de base de données accessible de l’extérieur (hôte:port) utilisée dans les identifiants générés par le panneau « Connexion à la base de données » de la base ; définissez-la pour activer l’accès SQL externe en lecture seule | - | - | db.example.com:42345 |
| PRISMA_TRANSACTION_TIMEOUT | Durée maximale (ms) pendant laquelle une transaction peut s’exécuter avant expiration. Augmentez-la pour les transactions longues (par ex., mises à jour en masse avec de nombreuses clés étrangères) | 5000 | - | 60000 |
| PRISMA_TRANSACTION_MAX_WAIT | Durée maximale (ms) d’attente pour acquérir une transaction du pool | 2000 | - | 5000 |
| BIG_TRANSACTION_TIMEOUT | Délai d’expiration (ms) des grandes transactions internes, comme l’exportation de grandes Bases | 600000 | - | 1200000 |
Secrets et rotation
Chaque valeur ci-dessus marquée comme secrète doit provenir de votre propre configuration. Le serveur les vérifie une fois au démarrage, mais l’absence d’un secret ne bloque jamais le démarrage : Teable utilise la valeur par défaut intégrée aux anciennes versions, consigne les variables manquantes et démarre. Ces valeurs intégrées sont publiques ; n’importe qui peut donc fabriquer des jetons ou déchiffrer les données protégées par celles-ci. Cela convient à un essai local rapide, mais n’est pas sûr dans les autres cas. Mise à niveau d’un déploiement existant. Une instance qui fonctionnait sans ces variables utilisait implicitement les anciennes valeurs intégrées et les utilise toujours. L’avertissement au démarrage affiche le bloc exact à ajouter afin que les sessions, les jetons et les données chiffrées actuels continuent de fonctionner. Copiez-le tel quel, redémarrez, puis prévoyez une rotation. Si votre format de configuration l’exige, n’oubliez pas d’échapper les caractères$ dans les valeurs.
Nouveau déploiement. Générez plutôt de nouvelles valeurs :
openssl rand -base64 32
openssl rand -hex 8 pour les emplacements *_ENCRYPTION_KEY et
*_ENCRYPTION_IV de 16 caractères.
Le journal de démarrage avertit également lorsqu’un secret est explicitement défini sur une ancienne
valeur par défaut publiquement connue. L’instance continue de fonctionner afin que vos données restent accessibles, mais
n’importe qui peut fabriquer des jetons ou déchiffrer les données protégées par cette valeur. Effectuez une rotation.