Settings reference¶

Generated from the settings model at build time. Every setting is an environment variable prefixed MES_ (or a line in .env); the table shows the default a laptop gets.

Setting	Environment variable	Default
`database_url`	`MES_DATABASE_URL`	`sqlite:///fsmes.db`
`sqlite_busy_timeout_ms`	`MES_SQLITE_BUSY_TIMEOUT_MS`	`15000`
`shadow`	`MES_SHADOW`	`false`
`log_level`	`MES_LOG_LEVEL`	`INFO`
`log_dir`	`MES_LOG_DIR`	`logs`
`api_host`	`MES_API_HOST`	`127.0.0.1`
`api_port`	`MES_API_PORT`	`8000`
`redundancy`	`MES_REDUNDANCY`	`false`
`node_id`	`MES_NODE_ID`
`lease_seconds`	`MES_LEASE_SECONDS`	`10.0`
`plant_name`	`MES_PLANT_NAME`
`plant_profile`	`MES_PLANT_PROFILE`	`laptop`
`plant_timezone`	`MES_PLANT_TIMEZONE`
`words`	`MES_WORDS`	`{}`
`secret_key`	`MES_SECRET_KEY`
`token_ttl_seconds`	`MES_TOKEN_TTL_SECONDS`	`43200`
`admin_password`	`MES_ADMIN_PASSWORD`	`admin`
`operator_password`	`MES_OPERATOR_PASSWORD`	`operator`
`opc_endpoint`	`MES_OPC_ENDPOINT`	`opc.tcp://127.0.0.1:4840/mes-twin/sim`
`opc_namespace`	`MES_OPC_NAMESPACE`	`urn:mes-twin:sim`
`tag_map_file`	`MES_TAG_MAP_FILE`	`config/tag_map.json`
`line_layout_file`	`MES_LINE_LAYOUT_FILE`	`config/line_layout.json`
`floor_script_file`	`MES_FLOOR_SCRIPT_FILE`
`opc_security`	`MES_OPC_SECURITY`
`opc_user`	`MES_OPC_USER`
`opc_password`	`MES_OPC_PASSWORD`
`opc_cert_dir`	`MES_OPC_CERT_DIR`	`certs`
`opc_application_uri`	`MES_OPC_APPLICATION_URI`	`urn:mes-twin:agent`
`replay_dir`	`MES_REPLAY_DIR`	`labs/kepsim/out`
`inbound_dir`	`MES_INBOUND_DIR`	`inbound`
`inbound_mapping_file`	`MES_INBOUND_MAPPING_FILE`	`config/inbound_mapping.json`
`inbound_poll_seconds`	`MES_INBOUND_POLL_SECONDS`	`10.0`
`inbound_sql_file`	`MES_INBOUND_SQL_FILE`	`config/inbound_sql.json`
`inbound_mqtt_mode`	`MES_INBOUND_MQTT_MODE`	`off`
`inbound_mqtt_broker_url`	`MES_INBOUND_MQTT_BROKER_URL`	`mqtt://127.0.0.1:1883`
`inbound_mqtt_username`	`MES_INBOUND_MQTT_USERNAME`
`inbound_mqtt_password`	`MES_INBOUND_MQTT_PASSWORD`
`inbound_mqtt_client_id`	`MES_INBOUND_MQTT_CLIENT_ID`	`fsmes-inbound`
`inbound_mqtt_qos`	`MES_INBOUND_MQTT_QOS`	`1`
`inbound_mqtt_source`	`MES_INBOUND_MQTT_SOURCE`
`inbound_mqtt_report_seconds`	`MES_INBOUND_MQTT_REPORT_SECONDS`	`60.0`
`erp_mode`	`MES_ERP_MODE`	`rest`
`erp_base_url`	`MES_ERP_BASE_URL`	`http://127.0.0.1:8001`
`erp_inbox`	`MES_ERP_INBOX`	`erp_exchange/inbox`
`erp_outbox`	`MES_ERP_OUTBOX`	`erp_exchange/outbox`
`erp_archive`	`MES_ERP_ARCHIVE`	`erp_exchange/archive`
`erp_poll_seconds`	`MES_ERP_POLL_SECONDS`	`5.0`
`erp_max_attempts`	`MES_ERP_MAX_ATTEMPTS`	`8`
`erp_base_backoff_s`	`MES_ERP_BASE_BACKOFF_S`	`5`
`erp_max_backoff_s`	`MES_ERP_MAX_BACKOFF_S`	`3600`
`erp_open_statuses`	`MES_ERP_OPEN_STATUSES`	`Not Started,In Process`
`erp_float_rel_tol`	`MES_ERP_FLOAT_REL_TOL`	`0.001`
`erp_float_abs_tol`	`MES_ERP_FLOAT_ABS_TOL`	`0.01`
`erp_http_timeout`	`MES_ERP_HTTP_TIMEOUT`	`30.0`
`erp_rest_timeout`	`MES_ERP_REST_TIMEOUT`	`10.0`
`erp_default_order_priority`	`MES_ERP_DEFAULT_ORDER_PRIORITY`	`50`
`erp_confirmation_seconds_tolerance`	`MES_ERP_CONFIRMATION_SECONDS_TOLERANCE`	`1.0`
`erpnext_base_url`	`MES_ERPNEXT_BASE_URL`	`http://localhost:8090`
`erpnext_site`	`MES_ERPNEXT_SITE`	`mes.localhost`
`erpnext_user`	`MES_ERPNEXT_USER`	`Administrator`
`erpnext_password`	`MES_ERPNEXT_PASSWORD`	`admin`
`erpnext_api_key`	`MES_ERPNEXT_API_KEY`
`erpnext_api_secret`	`MES_ERPNEXT_API_SECRET`
`erpnext_company`	`MES_ERPNEXT_COMPANY`
`erpnext_post_stock_entry`	`MES_ERPNEXT_POST_STOCK_ENTRY`	`true`
`outbox_domain_events`	`MES_OUTBOX_DOMAIN_EVENTS`	`true`
`uns_mode`	`MES_UNS_MODE`	`off`
`uns_broker_url`	`MES_UNS_BROKER_URL`	`mqtt://127.0.0.1:1883`
`uns_username`	`MES_UNS_USERNAME`
`uns_password`	`MES_UNS_PASSWORD`
`uns_client_id`	`MES_UNS_CLIENT_ID`	`fsmes`
`uns_topic_prefix`	`MES_UNS_TOPIC_PREFIX`	`umh/v1`
`uns_enterprise`	`MES_UNS_ENTERPRISE`
`uns_site`	`MES_UNS_SITE`
`uns_schema`	`MES_UNS_SCHEMA`	`_mes`
`uns_qos`	`MES_UNS_QOS`	`1`
`uns_retain`	`MES_UNS_RETAIN`	`false`
`uns_poll_seconds`	`MES_UNS_POLL_SECONDS`	`2.0`
`uns_batch`	`MES_UNS_BATCH`	`200`
`uns_inflight`	`MES_UNS_INFLIGHT`	`10`
`sim_speed`	`MES_SIM_SPEED`	`1.0`
`opc_publish_ms`	`MES_OPC_PUBLISH_MS`	`500`
`opc_health_periods`	`MES_OPC_HEALTH_PERIODS`	`3`
`tag_retention_days`	`MES_TAG_RETENTION_DAYS`	`14.0`
`opc_endpoints`	`MES_OPC_ENDPOINTS`
`oee_coverage_floor`	`MES_OEE_COVERAGE_FLOOR`	`0.0`
`oee_min_observed_seconds`	`MES_OEE_MIN_OBSERVED_SECONDS`	`10.0`
`quality_hold_rules`	`MES_QUALITY_HOLD_RULES`	`1,2,3,4`
`quality_major_rules`	`MES_QUALITY_MAJOR_RULES`	`1`
`quality_cpk_capable`	`MES_QUALITY_CPK_CAPABLE`	`1.33`
`quality_cpk_marginal`	`MES_QUALITY_CPK_MARGINAL`	`1.0`
`quality_spc_min_points`	`MES_QUALITY_SPC_MIN_POINTS`	`12`
`quality_spc_history`	`MES_QUALITY_SPC_HISTORY`	`200`
`quality_gauge_ratio_adequate`	`MES_QUALITY_GAUGE_RATIO_ADEQUATE`	`10.0`
`quality_gauge_ratio_floor`	`MES_QUALITY_GAUGE_RATIO_FLOOR`	`4.0`
`quality_gauge_default_interval_days`	`MES_QUALITY_GAUGE_DEFAULT_INTERVAL_DAYS`	`365`
`quality_coa_serials_listed`	`MES_QUALITY_COA_SERIALS_LISTED`	`200`
`quality_serial_digits`	`MES_QUALITY_SERIAL_DIGITS`	`6`
`quality_nc_code_prefix`	`MES_QUALITY_NC_CODE_PREFIX`	`NC`
`quality_containment_max_depth`	`MES_QUALITY_CONTAINMENT_MAX_DEPTH`	`6`
`process_maintenance_due_soon_fraction`	`MES_PROCESS_MAINTENANCE_DUE_SOON_FRACTION`	`0.8`
`process_default_cycle_seconds`	`MES_PROCESS_DEFAULT_CYCLE_SECONDS`	`3.0`
`process_default_job_minutes`	`MES_PROCESS_DEFAULT_JOB_MINUTES`	`60.0`
`process_maintenance_plan_default_minutes`	`MES_PROCESS_MAINTENANCE_PLAN_DEFAULT_MINUTES`	`30.0`
`process_default_report_hours`	`MES_PROCESS_DEFAULT_REPORT_HOURS`	`8.0`
`process_report_windows`	`MES_PROCESS_REPORT_WINDOWS`	`0.25,1,8,24,168`
`process_gantt_screenful`	`MES_PROCESS_GANTT_SCREENFUL`	`12`
`process_previous_shift_horizon_days`	`MES_PROCESS_PREVIOUS_SHIFT_HORIZON_DAYS`	`14`
`process_working_week_mask`	`MES_PROCESS_WORKING_WEEK_MASK`	`1111100`
`process_schedule_default_horizon_hours`	`MES_PROCESS_SCHEDULE_DEFAULT_HORIZON_HOURS`	`24.0`
`controls_opc_book_attempts`	`MES_CONTROLS_OPC_BOOK_ATTEMPTS`	`4`
`controls_opc_book_backoff_s`	`MES_CONTROLS_OPC_BOOK_BACKOFF_S`	`0.5`
`controls_uns_max_attempts`	`MES_CONTROLS_UNS_MAX_ATTEMPTS`	`8`
`controls_uns_base_backoff_s`	`MES_CONTROLS_UNS_BASE_BACKOFF_S`	`5`
`controls_uns_max_backoff_s`	`MES_CONTROLS_UNS_MAX_BACKOFF_S`	`3600`
`controls_trigger_reload_seconds`	`MES_CONTROLS_TRIGGER_RELOAD_SECONDS`	`30.0`
`controls_trigger_default_cooldown_seconds`	`MES_CONTROLS_TRIGGER_DEFAULT_COOLDOWN_SECONDS`	`300.0`
`controls_opc_history_ratio`	`MES_CONTROLS_OPC_HISTORY_RATIO`	`10`
`controls_opc_min_history_ms`	`MES_CONTROLS_OPC_MIN_HISTORY_MS`	`1000`
`controls_opc_order_sync_seconds`	`MES_CONTROLS_OPC_ORDER_SYNC_SECONDS`	`2.0`
`controls_opc_adjustment_poll_seconds`	`MES_CONTROLS_OPC_ADJUSTMENT_POLL_SECONDS`	`5.0`
`admin_default_new_account_role`	`MES_ADMIN_DEFAULT_NEW_ACCOUNT_ROLE`	`operator`
`admin_list_default_limit`	`MES_ADMIN_LIST_DEFAULT_LIMIT`	`50`
`admin_list_max_limit`	`MES_ADMIN_LIST_MAX_LIMIT`	`500`
`admin_pending_approvals_page_size`	`MES_ADMIN_PENDING_APPROVALS_PAGE_SIZE`	`20`
`admin_walkthrough_max_steps`	`MES_ADMIN_WALKTHROUGH_MAX_STEPS`	`60`
`admin_walkthrough_title_chars`	`MES_ADMIN_WALKTHROUGH_TITLE_CHARS`	`120`
`admin_walkthrough_body_chars`	`MES_ADMIN_WALKTHROUGH_BODY_CHARS`	`1000`
`admin_walkthrough_fill_chars`	`MES_ADMIN_WALKTHROUGH_FILL_CHARS`	`200`
`admin_walkthrough_tab_chars`	`MES_ADMIN_WALKTHROUGH_TAB_CHARS`	`60`
`admin_walkthrough_default_capability`	`MES_ADMIN_WALKTHROUGH_DEFAULT_CAPABILITY`	`plant.read`
`admin_agent_max_rounds`	`MES_ADMIN_AGENT_MAX_ROUNDS`	`12`
`admin_agent_session_ttl_seconds`	`MES_ADMIN_AGENT_SESSION_TTL_SECONDS`	`1800`
`admin_agent_result_limit`	`MES_ADMIN_AGENT_RESULT_LIMIT`	`12000`
`admin_assistant_context_chars`	`MES_ADMIN_ASSISTANT_CONTEXT_CHARS`	`3000`
`admin_design_compress_budget`	`MES_ADMIN_DESIGN_COMPRESS_BUDGET`	`2500`
`admin_design_compress_source_chars`	`MES_ADMIN_DESIGN_COMPRESS_SOURCE_CHARS`	`12000`
`admin_design_source_budget`	`MES_ADMIN_DESIGN_SOURCE_BUDGET`	`14000`
`admin_assistant_timeout_seconds`	`MES_ADMIN_ASSISTANT_TIMEOUT_SECONDS`	`60.0`
`admin_drafting_timeout_seconds`	`MES_ADMIN_DRAFTING_TIMEOUT_SECONDS`	`180.0`
`admin_design_generate_timeout_seconds`	`MES_ADMIN_DESIGN_GENERATE_TIMEOUT_SECONDS`	`120.0`
`admin_design_classify_timeout_seconds`	`MES_ADMIN_DESIGN_CLASSIFY_TIMEOUT_SECONDS`	`45.0`
`admin_design_compress_timeout_seconds`	`MES_ADMIN_DESIGN_COMPRESS_TIMEOUT_SECONDS`	`90.0`
`admin_design_chat_timeout_seconds`	`MES_ADMIN_DESIGN_CHAT_TIMEOUT_SECONDS`	`240.0`
`admin_document_house_style`	`MES_ADMIN_DOCUMENT_HOUSE_STYLE`	`- Markdown. A one-line Purpose, then numbered Steps, then a short
"If it fails" section.
- Six to ten steps. Each step is one action, in the imperative.
- No preamble, no closing remarks, no headings above the Purpose line.`
`admin_ai_rollup_stale_hours`	`MES_ADMIN_AI_ROLLUP_STALE_HOURS`	`40`
`admin_ai_trace_days`	`MES_ADMIN_AI_TRACE_DAYS`	`90`
`screens_floor_refresh_ms`	`MES_SCREENS_FLOOR_REFRESH_MS`	`2000`
`screens_floor_pending_refresh_ms`	`MES_SCREENS_FLOOR_PENDING_REFRESH_MS`	`30000`
`screens_admin_refresh_ms`	`MES_SCREENS_ADMIN_REFRESH_MS`	`8000`
`screens_floor_machine_page`	`MES_SCREENS_FLOOR_MACHINE_PAGE`	`24`
`screens_floor_order_page`	`MES_SCREENS_FLOOR_ORDER_PAGE`	`10`
`screens_floor_spec_choices`	`MES_SCREENS_FLOOR_SPEC_CHOICES`	`200`
`screens_admin_user_page_size`	`MES_SCREENS_ADMIN_USER_PAGE_SIZE`	`25`
`screens_admin_routing_page_size`	`MES_SCREENS_ADMIN_ROUTING_PAGE_SIZE`	`25`
`screens_all_pages_limit`	`MES_SCREENS_ALL_PAGES_LIMIT`	`500`
`screens_all_pages_cap`	`MES_SCREENS_ALL_PAGES_CAP`	`2000`
`screens_toast_ms`	`MES_SCREENS_TOAST_MS`	`3500`
`screens_input_debounce_ms`	`MES_SCREENS_INPUT_DEBOUNCE_MS`	`250`
`screens_assistant_log_entries`	`MES_SCREENS_ASSISTANT_LOG_ENTRIES`	`60`
`screens_assistant_fill_attempts`	`MES_SCREENS_ASSISTANT_FILL_ATTEMPTS`	`20`
`screens_assistant_fill_wait_ms`	`MES_SCREENS_ASSISTANT_FILL_WAIT_MS`	`150`
`system_fleet_health_probe_timeout`	`MES_SYSTEM_FLEET_HEALTH_PROBE_TIMEOUT`	`3.0`
`system_log_rotation_max_bytes`	`MES_SYSTEM_LOG_ROTATION_MAX_BYTES`	`5000000`
`system_log_rotation_backups`	`MES_SYSTEM_LOG_ROTATION_BACKUPS`	`5`
`system_local_model_name`	`MES_SYSTEM_LOCAL_MODEL_NAME`	`qwen3:8b`
`jev_api_key`	`MES_JEV_API_KEY`
`jev_model`	`MES_JEV_MODEL`	`jev-1.13.0`
`jev_base_url`	`MES_JEV_BASE_URL`
`jev_timeout_seconds`	`MES_JEV_TIMEOUT_SECONDS`	`5.0`
`modules`	`MES_MODULES`	`all`

A plant pack carries per-plant values that compile to these; see plant packs. MES_WORDS is what a pack's [words] table becomes, and a pack is where it is checked.