Skip to main content
For production deployments, use S3-compatible object storage (s3 / minio) with public/private dual buckets. Also ensure the public bucket is configured with public-read + CORS. See: Object Storage (S3-compatible).
Environment VariableDescriptionDefault ValueRequiredExample
Core Configuration
PUBLIC_ORIGINPublic origin for generating complete URLs, must be set to your app’s access address-Yeshttps://app.teable.ai
SECRET_KEYKey for JWT, sessions, and sharing, use a strong passworddefaultSecretKeyYesyourStrongSecretKey
PORTPort on which the application runs3000-3000
LOG_LEVELLog level, options: fatal, error, warn, info, debug, traceinfo-debug
NEXT_ENV_IMAGES_ALL_REMOTEWhether to allow loading third-party imagesfalse-true
Storage Configuration
BACKEND_STORAGE_PROVIDERStorage provider, options: local, minio, s3, aliyunlocal-s3
BACKEND_STORAGE_LOCAL_PATHLocal storage path.assets/uploads-.assets/uploads
BACKEND_STORAGE_PUBLIC_BUCKETPublic bucket namepublic-teable-public
BACKEND_STORAGE_PRIVATE_BUCKETPrivate bucket nameprivate-teable-private
BACKEND_STORAGE_PUBLIC_URLPublic URL override for public bucket (optional)--https://cdn.example.com
BACKEND_STORAGE_PRIVATE_BUCKET_ENDPOINTPrivate bucket endpoint override (optional)--https://private-bucket.endpoint
BACKEND_STORAGE_S3_REGIONS3 storage region, required when BACKEND_STORAGE_PROVIDER is s3--us-east-2
BACKEND_STORAGE_S3_ENDPOINTS3 storage endpoint, required when BACKEND_STORAGE_PROVIDER is s3--https://s3.us-east-2.amazonaws.com
BACKEND_STORAGE_S3_INTERNAL_ENDPOINTS3 internal endpoint (optional)--http://s3.internal
BACKEND_STORAGE_S3_ACCESS_KEYS3 storage access key, required when BACKEND_STORAGE_PROVIDER is s3--your_access_key
BACKEND_STORAGE_S3_SECRET_KEYS3 storage secret key, required when BACKEND_STORAGE_PROVIDER is s3--your_secret_key
BACKEND_STORAGE_S3_MAX_SOCKETSS3 max sockets (optional)100-100
BACKEND_STORAGE_MINIO_ENDPOINTMinIO storage endpoint--minio.example.com
BACKEND_STORAGE_MINIO_PORTMinIO port9000-443
BACKEND_STORAGE_MINIO_USE_SSLWhether MinIO uses SSLfalse-true
BACKEND_STORAGE_MINIO_ACCESS_KEYMinIO access key--access-key
BACKEND_STORAGE_MINIO_SECRET_KEYMinIO secret key--secret-key
BACKEND_STORAGE_MINIO_INTERNAL_ENDPOINTMinIO internal endpoint (optional, no HTTPS)--minio.internal
BACKEND_STORAGE_MINIO_INTERNAL_PORTMinIO internal port (optional)9000-9000
BACKEND_STORAGE_MINIO_REGIONMinIO region (optional)--us-east-1
BACKEND_STORAGE_UPLOAD_METHODUpload methodput-put
STORAGE_PREFIXStorage prefix, defaults to PUBLIC_ORIGINPUBLIC_ORIGIN-http://localhost:3000
Cache Configuration
BACKEND_CACHE_PROVIDERCache provider, options: sqlite, memory, redissqlite-redis
BACKEND_CACHE_REDIS_URIRedis cache connection URI, required when BACKEND_CACHE_PROVIDER is redis--redis://default:teable@127.0.0.1:6379/0
Performance Cache Configuration
BACKEND_PERFORMANCE_CACHEPerformance cache Redis URL for query result caching, improves multi-user collaboration efficiency. Recommended to use separate Redis instance from BACKEND_CACHE_REDIS_URI--redis://default:teable@127.0.0.1:6379/0
Authentication Configuration
SOCIAL_AUTH_PROVIDERSList of social auth providers, comma-separated--github,google,oidc
BACKEND_GITHUB_CLIENT_IDGitHub OAuth client ID--github_client_id
BACKEND_GITHUB_CLIENT_SECRETGitHub OAuth client secret--github_client_secret
BACKEND_GOOGLE_CLIENT_IDGoogle OAuth client ID--google_client_id
BACKEND_GOOGLE_CLIENT_SECRETGoogle OAuth client secret--google_client_secret
BACKEND_OIDC_CLIENT_IDOIDC client ID--google_client_id
BACKEND_OIDC_CLIENT_SECRETOIDC client secret--google_client_secret
BACKEND_OIDC_CALLBACK_URLOIDC callback URL--https://app.teable.ai/api/auth/oidc/callback
Security & Verification
TURNSTILE_SITE_KEYCloudflare Turnstile site key for authentication verification--1x00000000000000000000AA
TURNSTILE_SECRET_KEYCloudflare Turnstile secret key for authentication verification--1x0000000000000000000000000000000AA
BACKEND_SIGNUP_VERIFICATION_CODE_RATE_LIMIT_SECONDSRate limit interval (seconds) for sending signup verification emails--30
Email Configuration (Deprecated - Use Admin Panel > Instance settings > Email)
BACKEND_MAIL_HOSTDefault mail server address. We recommend configuring Notify email and Automation email visually in Admin Panel > Instance settings > Emailsmtp.teable.ai-smtp.gmail.com
BACKEND_MAIL_PORTDefault mail server port465-465
BACKEND_MAIL_SECUREWhether the default mail service uses SSL/TLStrue-true
BACKEND_MAIL_SENDERDefault sender addressnoreply.teable.ai-noreply@company.com
BACKEND_MAIL_SENDER_NAMEDefault sender nameTeable-Teable
BACKEND_MAIL_AUTH_USERDefault mail server authentication username--username
BACKEND_MAIL_AUTH_PASSDefault mail server authentication password--usertoken
Session/JWT Configuration
BACKEND_SESSION_EXPIRES_INSession expiration time7d-7d
BACKEND_SESSION_COOKIE_SECUREWhether to secure session cookiefalse-true
BACKEND_SESSION_ORIGIN_CHECK_ENABLEDEnable Origin and Fetch Metadata checks for unsafe browser session-cookie API requests. Enable only when your reverse proxy or CDN preserves these headersfalse-false
BACKEND_JWT_EXPIRES_INJWT expiration time20d-20d
BACKEND_RESET_PASSWORD_EMAIL_EXPIRES_INReset password email expiration time30m-30m
Resource Limits
MAX_COPY_CELLSMaximum number of cells to copy in a single request--50000
MAX_READ_ROWSMaximum number of rows to read in a single request--10000
MAX_ATTACHMENT_UPLOAD_SIZEMaximum attachment upload size (bytes)--2147483648
MAX_SPACE_OWNER_COUNTMaximum number of spaces a user can own10-10
TASK_MAX_FIELDS_PER_BATCHMaximum number of AI fields sent to the model in one batch request. Values are clamped from 1 to 205-5
TASK_MAX_CONCURRENCYMaximum pending AI field task runs dispatched in one scheduling cycle. Values are clamped from 1 to 205-5
TABLE_LIMIT_FIELD_OPTIONS_MAX_BYTESMaximum serialized field option bytes262144-262144
TABLE_LIMIT_SELECT_CHOICES_MAXMaximum select choices per select field1000-1000
TABLE_LIMIT_SELECT_CHOICE_NAME_MAX_LENGTHMaximum select choice name length1000-1000
TABLE_LIMIT_SELECT_DEFAULT_VALUES_MAXMaximum select default values100-100
TABLE_LIMIT_CELL_VALUE_MAX_BYTESMaximum cell value bytes262144-262144
TABLE_LIMIT_RECORD_FIELDS_MAX_BYTESMaximum serialized record fields bytes1048576-1048576
TABLE_LIMIT_RECORDS_PER_MUTATION_MAXMaximum records per mutation20000-20000
TABLE_LIMIT_COMPUTED_CELL_VALUE_MAX_BYTESMaximum computed cell value bytes262144-262144
TABLE_LIMIT_FORMULA_MAX_LENGTHMaximum formula length8192-8192
TABLE_LIMIT_TABLES_PER_BASE_MAXMaximum tables per base1000-1000
TABLE_LIMIT_FIELDS_PER_TABLE_MAXMaximum fields per table500-500
TABLE_LIMIT_VIEWS_PER_TABLE_MAXMaximum views per table100-100
TABLE_LIMIT_CREATE_TABLE_FIELDS_MAXMaximum fields accepted when creating a table1000-1000
TABLE_LIMIT_CREATE_TABLE_VIEWS_MAXMaximum views accepted when creating a table20-20
TABLE_LIMIT_CREATE_TABLE_RECORDS_MAXMaximum records accepted when creating a table20000-20000
TABLE_LIMIT_RECORDS_PER_TABLE_MAXMaximum rows per table. Empty means no instance-level row limit--1000000
TABLE_LIMIT_VIEW_FILTER_ITEMS_MAXMaximum filter items in a view100-100
TABLE_LIMIT_VIEW_FILTER_DEPTH_MAXMaximum nested filter depth in a view5-5
TABLE_LIMIT_VIEW_SORT_ITEMS_MAXMaximum sort items in a view20-20
TABLE_LIMIT_VIEW_GROUP_ITEMS_MAXMaximum group items in a view3-3
TABLE_LIMIT_VIEW_OPTIONS_MAX_BYTESMaximum serialized view option bytes262144-262144
TABLE_LIMIT_NAME_MAX_LENGTHMaximum display name length for supported table objects100-100
TABLE_LIMIT_DESCRIPTION_MAX_LENGTHMaximum description length for supported table objects2000-2000
Feature Toggles
RECORD_HISTORY_DISABLEDWhether to disable record history, defaults to falsefalse-true
PASSWORD_LOGIN_DISABLEDWhether to disable password login (OAuth and OIDC still available)false-true
Analytics & Monitoring
MICROSOFT_CLARITY_IDMicrosoft Clarity metrics ID, for enabling Microsoft Clarity analytics--your-metrics-id
OTEL_EXPORTER_OTLP_ENDPOINTOpenTelemetry OTLP endpoint--http://jaeger:4317
TELEMETRY_REPORT_DISABLEDDisable self-hosted telemetry reporting, including license compliance reports from connected instancesfalse-true
Database Configuration
PRISMA_DATABASE_URLDatabase connection URL, must be configured-Yespostgresql://teable:teable@127.0.0.1:5432/teable
PRISMA_TRANSACTION_TIMEOUTMaximum time (ms) a transaction can run before timing out. Increase for long-running transactions (e.g., bulk updates with many foreign keys)5000-60000
PRISMA_TRANSACTION_MAX_WAITMaximum time (ms) to wait to acquire a transaction from the pool2000-5000
Last modified on June 9, 2026