Update dynamic server configuration.
Apply a partial update to the dynamic settings backed by config.json.
Only fields defined on DynamicSettings may be changed here — bootstrap fields (Mongo
connection, filestorage paths, plugins path, ...) are immutable at runtime. Validated,
persisted atomically, applied in-memory, and any required side effects (OTEL reconfigure)
are triggered — all without an API process restart. The separate Nightshift worker notices
the new config.json on its own and re-execs itself (see server.workers.nightshift).
AuthorizationBearer <token>application/json- body
[key: string]?anySuccessful Response
application/json- response
The subset of AppSettings fields that live in config.json.
server_url?string"http://localhost:8000"infra?Model for an infra endpoint.
{ "url": "http://127.0.0.1:8086", "api_key": "", "admin_api_key": ""}chat_translation_model?string"gemma3:1b"vector_database?{ "provider": { "active": false, "db": "default", "password": "Milvus", "type": "milvus", "url": "http://localhost:19530", "user": "root" }, "embedding": { "active": false, "model": "mxbai", "size": 1024, "sparse": false }, "reranker": { "active": false, "min_fetch_k": 50, "model": "BAAI/bge-reranker-v2-m3", "oversampling": 2.5 }, "search": { "default_num_results": 5, "max_num_results": 20 }, "vector_threshold": 0.3}plugins_setup?{}ti_api_key?string""otel_exporter_otlp_endpoint?string"http://localhost:4317"otel_tracing_enabled?booleanfalseotel_logging_enabled?booleanfalsesentry_enabled?booleanfalsesentry_dsn?string""sentry_environment?string""log_level?string"INFO"evaluate_model?string"gemma3:1b"metrics_username?string""metrics_password?string""embedding_worker_count?integer5embedding_batch_size?integer10only_admin_can_create_accounts_by_invitation?booleantruesmtp?{ "host": "localhost", "port": 25, "auth": false, "user": "", "password": "", "email_from": "no-reply@domain.com", "use_tls": false}reranker_worker_count?integer5llm_worker_count?integer1 <= value10doc_chunker_prefix?string"doc_chunker"doc_chunker_picture_description_model?string"gemma4:e4b"doc_chunker_stt_model?string"Systran/faster-whisper-large-v3"doc_chunker_convert_timeout_seconds?integer1 <= value7200doc_chunker_poll_interval_seconds?number0 < value5doc_chunker_request_timeout_seconds?integer1 <= value300lemmatizer_endpoint_prefix?string"lemmatizer"lemmatizer_worker_count?integer5fine_tuning_poll_interval_seconds?integer60fine_tuning_max_worker_sync_failures?integer5metadata_expansion_model?string"gemma3:1b"metadata_expansion_max_attempts?integer3metadata_expansion_concurrency?integer1 <= value <= 644summarization_model?string"gemma4:12b"summarization_max_attempts?integer3summarization_concurrency?integer1 <= value <= 644nightshift_jobs_timeout_seconds?number1 <= value10800mcp_session_ttl_seconds?integer300mcp_session_sweep_interval_seconds?integer60graph?{ "enabled": false, "host": "localhost", "port": 6379, "username": "", "password": "", "ssl": false, "llm_model": "gpt-4o-mini", "embedding_model": "text-embedding-3-small", "embedding_dim": 1536, "document_min_chars": 1000, "document_max_chars": 8000, "entity_extractor_prefix": "gliner", "entity_extractor_timeout_seconds": 30, "entity_extractor_threshold": 0.75, "entity_extractor_max_retries": 2, "fuzzy_dedup_enabled": false, "fuzzy_dedup_threshold": 0.95, "document_ingestion_concurrency": 4, "ontology_discovery_llm_model": "gpt-4o-mini", "ontology_discovery_sample_chunks_per_doc": 3, "ontology_discovery_concurrency": 4, "ontology_discovery_max_sample_files": 10, "ontology_discovery_max_attempts": 3, "ontology_discovery_llm_call_attempts": 4, "ontology_discovery_max_new_entities": 0, "ontology_discovery_max_new_relations": 0, "ontology_discovery_semantic_fold_mode": "warn", "ontology_discovery_semantic_fold_threshold": 0.85, "document_ingestion_max_attempts": 3, "ingestion_stale_after_seconds": 7200, "orphan_sweep_interval_seconds": 3600}vector_store_expiry_sweep_interval_seconds?integer1 <= value300upload_expiry_sweep_interval_seconds?integer1 <= value300max_concurrent_requests?integer1 <= value100max_output_tokens_limit?integer1 <= value524288max_context_tokens_limit?integer1 <= value16777216rabbitmq?Connection to the RabbitMQ broker Nightshift jobs are dispatched through.
{ "host": "localhost", "port": 5672, "username": "guest", "password": "guest", "vhost": "/", "ssl": false, "connect_timeout_seconds": 10}finetune_pipelines?Scheduled fine-tuning pipelines (/v1/fine_tuning/pipelines), run by Nightshift.
{ "tick_seconds": 60, "max_active_runs": 1, "generation_model": "gemma3:1b", "generation_concurrency": 4, "promotion_timeout_seconds": 21600, "max_chunks_per_run": 2000, "max_failed_chunk_ratio": 0.5, "min_training_pairs": 20, "eval_size": 50, "eval_max_new_tokens": 512, "judge_model": "gemma3:1b", "first_version_min_score": 3, "step_max_attempts": 3, "vllm_service_id": "vllm"}curl -X PUT 'https://deepfellow-server-host/admin/config' \ -H 'Content-Type: application/json' \ -d '{}'{ "server_url": "http://localhost:8000", "infra": { "url": "http://127.0.0.1:8086", "api_key": "", "admin_api_key": "" }, "chat_translation_model": "gemma3:1b", "vector_database": { "provider": { "active": false, "db": "default", "password": "Milvus", "type": "milvus", "url": "http://localhost:19530", "user": "root" }, "embedding": { "active": false, "model": "mxbai", "size": 1024, "sparse": false }, "reranker": { "active": false, "min_fetch_k": 50, "model": "BAAI/bge-reranker-v2-m3", "oversampling": 2.5 }, "search": { "default_num_results": 5, "max_num_results": 20 }, "vector_threshold": 0.3 }, "plugins_setup": {}, "ti_api_key": "", "otel_exporter_otlp_endpoint": "http://localhost:4317", "otel_tracing_enabled": false, "otel_logging_enabled": false, "sentry_enabled": false, "sentry_dsn": "", "sentry_environment": "", "log_level": "INFO", "evaluate_model": "gemma3:1b", "metrics_username": "", "metrics_password": "", "embedding_worker_count": 5, "embedding_batch_size": 10, "only_admin_can_create_accounts_by_invitation": true, "smtp": { "host": "localhost", "port": 25, "auth": false, "user": "", "password": "", "email_from": "no-reply@domain.com", "use_tls": false }, "reranker_worker_count": 5, "llm_worker_count": 10, "doc_chunker_prefix": "doc_chunker", "doc_chunker_picture_description_model": "gemma4:e4b", "doc_chunker_stt_model": "Systran/faster-whisper-large-v3", "doc_chunker_convert_timeout_seconds": 7200, "doc_chunker_poll_interval_seconds": 5, "doc_chunker_request_timeout_seconds": 300, "lemmatizer_endpoint_prefix": "lemmatizer", "lemmatizer_worker_count": 5, "fine_tuning_poll_interval_seconds": 60, "fine_tuning_max_worker_sync_failures": 5, "metadata_expansion_model": "gemma3:1b", "metadata_expansion_max_attempts": 3, "metadata_expansion_concurrency": 4, "summarization_model": "gemma4:12b", "summarization_max_attempts": 3, "summarization_concurrency": 4, "nightshift_jobs_timeout_seconds": 10800, "mcp_session_ttl_seconds": 300, "mcp_session_sweep_interval_seconds": 60, "graph": { "enabled": false, "host": "localhost", "port": 6379, "username": "", "password": "", "ssl": false, "llm_model": "gpt-4o-mini", "embedding_model": "text-embedding-3-small", "embedding_dim": 1536, "document_min_chars": 1000, "document_max_chars": 8000, "entity_extractor_prefix": "gliner", "entity_extractor_timeout_seconds": 30, "entity_extractor_threshold": 0.75, "entity_extractor_max_retries": 2, "fuzzy_dedup_enabled": false, "fuzzy_dedup_threshold": 0.95, "document_ingestion_concurrency": 4, "ontology_discovery_llm_model": "gpt-4o-mini", "ontology_discovery_sample_chunks_per_doc": 3, "ontology_discovery_concurrency": 4, "ontology_discovery_max_sample_files": 10, "ontology_discovery_max_attempts": 3, "ontology_discovery_llm_call_attempts": 4, "ontology_discovery_max_new_entities": 0, "ontology_discovery_max_new_relations": 0, "ontology_discovery_semantic_fold_mode": "warn", "ontology_discovery_semantic_fold_threshold": 0.85, "document_ingestion_max_attempts": 3, "ingestion_stale_after_seconds": 7200, "orphan_sweep_interval_seconds": 3600 }, "vector_store_expiry_sweep_interval_seconds": 300, "upload_expiry_sweep_interval_seconds": 300, "max_concurrent_requests": 100, "max_output_tokens_limit": 524288, "max_context_tokens_limit": 16777216, "rabbitmq": { "host": "localhost", "port": 5672, "username": "guest", "password": "guest", "vhost": "/", "ssl": false, "connect_timeout_seconds": 10 }, "finetune_pipelines": { "tick_seconds": 60, "max_active_runs": 1, "generation_model": "gemma3:1b", "generation_concurrency": 4, "promotion_timeout_seconds": 21600, "max_chunks_per_run": 2000, "max_failed_chunk_ratio": 0.5, "min_training_pairs": 20, "eval_size": 50, "eval_max_new_tokens": 512, "judge_model": "gemma3:1b", "first_version_min_score": 3, "step_max_attempts": 3, "vllm_service_id": "vllm" }}We use cookies on our website. We use them to ensure proper functioning of the site and, if you agree, for purposes such as analytics, marketing, and targeting ads.