Configuration

Environment variables

Variables read by TraDoc and deployment recommendations.

VariableDefaultPurpose
ENVproductionEnvironment name.
DATA_DIR./dataRoot for SQLite, projects, glossaries, outputs and credentials.
ALLOWED_ORIGINSemptyAdditional allowed origins, comma-separated.
ALLOWED_LLM_HOSTSemptyExplicitly allowed LLM hosts.
TRUSTED_LAN_PROXYfalseAllows the local LAN proxy; managed automatically by main.py dev.
LLM_ENDPOINThttp://localhost:1234/v1Initial provider URL.
LLM_API_KEYlm-studioInitial key or placeholder for a local service.
LLM_MODELqwen3.5-instructInitial model.
API_TYPEopenaiInitial provider adapter.
CONCURRENCY1Simultaneous requests, maximum 32.
CHUNK_TOKEN_SIZE1000Target segment size, from 200 to 10000.
MAX_RETRIES3Attempts, from 1 to 10.
REQUEST_TIMEOUT180.0Provider timeout in seconds.
TEMPERATURE0.15Model temperature, from 0 to 2.
MAX_UPLOAD_BYTES209715200Maximum import size, 200 MiB by default.
MAX_ARCHIVE_ENTRIES20000Maximum number of archive entries.
MAX_ARCHIVE_UNCOMPRESSED_BYTES1073741824Maximum uncompressed size, 1 GiB by default.
ENABLE_PROOFREADINGfalseEnables conditional proofreading features.
DEFAULT_SOURCE_LANGenInitial source language.
DEFAULT_TARGET_LANGfrInitial target language.

Rules

  • For source installs or explicit overrides, create .env from .env.example, replace the placeholders, and never commit it.
  • An older APP_SECRET value in .env is ignored and can be deleted.
  • A Docker environment variable overrides the value read from .env by the application.
  • If you share a diagnostic, back up or redact configuration separately from keys and documents.