DeepFellow DOCS

Update dynamic server configuration.

PUT
/admin/config

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).

Authorization

headerAuthorizationBearer <token>

Request Body

application/json
  1. body
[key: string]?any

Response Body

Successful Response

application/json
  1. response

The subset of AppSettings fields that live in config.json.

server_url?string
Default"http://localhost:8000"
infra?

Model for an infra endpoint.

Default
{  "url": "http://127.0.0.1:8086",  "api_key": "",  "admin_api_key": ""}
chat_translation_model?string
Default"gemma3:1b"
vector_database?
Default
{  "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?
Default{}
ti_api_key?string
Default""
otel_exporter_otlp_endpoint?string
Default"http://localhost:4317"
otel_tracing_enabled?boolean
Defaultfalse
otel_logging_enabled?boolean
Defaultfalse
sentry_enabled?boolean
Defaultfalse
sentry_dsn?string
Default""
sentry_environment?string
Default""
log_level?string
Default"INFO"
evaluate_model?string
Default"gemma3:1b"
metrics_username?string
Default""
metrics_password?string
Default""
embedding_worker_count?integer
Default5
embedding_batch_size?integer
Default10
only_admin_can_create_accounts_by_invitation?boolean
Defaulttrue
smtp?
Default
{  "host": "localhost",  "port": 25,  "auth": false,  "user": "",  "password": "",  "email_from": "no-reply@domain.com",  "use_tls": false}
reranker_worker_count?integer
Default5
llm_worker_count?integer
Range1 <= value
Default10
doc_chunker_prefix?string
Default"doc_chunker"
doc_chunker_picture_description_model?string
Default"gemma4:e4b"
doc_chunker_stt_model?string
Default"Systran/faster-whisper-large-v3"
doc_chunker_convert_timeout_seconds?integer
Range1 <= value
Default7200
doc_chunker_poll_interval_seconds?number
Range0 < value
Default5
doc_chunker_request_timeout_seconds?integer
Range1 <= value
Default300
lemmatizer_endpoint_prefix?string
Default"lemmatizer"
lemmatizer_worker_count?integer
Default5
fine_tuning_poll_interval_seconds?integer
Default60
fine_tuning_max_worker_sync_failures?integer
Default5
metadata_expansion_model?string
Default"gemma3:1b"
metadata_expansion_max_attempts?integer
Default3
metadata_expansion_concurrency?integer
Range1 <= value <= 64
Default4
summarization_model?string
Default"gemma4:12b"
summarization_max_attempts?integer
Default3
summarization_concurrency?integer
Range1 <= value <= 64
Default4
nightshift_jobs_timeout_seconds?number
Range1 <= value
Default10800
mcp_session_ttl_seconds?integer
Default300
mcp_session_sweep_interval_seconds?integer
Default60
graph?
Default
{  "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?integer
Range1 <= value
Default300
upload_expiry_sweep_interval_seconds?integer
Range1 <= value
Default300
max_concurrent_requests?integer
Range1 <= value
Default100
max_output_tokens_limit?integer
Range1 <= value
Default524288
max_context_tokens_limit?integer
Range1 <= value
Default16777216
rabbitmq?

Connection to the RabbitMQ broker Nightshift jobs are dispatched through.

Default
{  "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.

Default
{  "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"}
Example Request
curl -X PUT 'https://deepfellow-server-host/admin/config' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "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.