{"record":{"id":"25e8b9447d162630","repo":"Mintplex-Labs/anything-llm","slug":"docker-model-runner-base-path-must-be-provided-to","errorCode":null,"errorMessage":"Docker Model Runner base path must be provided to use agents.","messagePattern":"Docker Model Runner base path must be provided to use agents\\.","errorType":"exception","errorClass":"Error","httpStatus":null,"severity":"error","filePath":"server/utils/agents/index.js","lineNumber":265,"sourceCode":"      case \"cometapi\":\n        if (!process.env.COMETAPI_LLM_API_KEY)\n          throw new Error(\"CometAPI API Key must be provided to use agents.\");\n        break;\n      case \"foundry\":\n        if (!process.env.FOUNDRY_BASE_PATH)\n          throw new Error(\"Foundry base path must be provided to use agents.\");\n        break;\n      case \"giteeai\":\n        if (!process.env.GITEE_AI_API_KEY)\n          throw new Error(\"GiteeAI API Key must be provided to use agents.\");\n        break;\n      case \"cohere\":\n        if (!process.env.COHERE_API_KEY)\n          throw new Error(\"Cohere API key must be provided to use agents.\");\n        break;\n      case \"docker-model-runner\":\n        if (!process.env.DOCKER_MODEL_RUNNER_BASE_PATH)\n          throw new Error(\n            \"Docker Model Runner base path must be provided to use agents.\"\n          );\n        break;\n      case \"privatemode\":\n        if (!process.env.PRIVATEMODE_LLM_BASE_PATH)\n          throw new Error(\n            \"Privatemode base path must be provided to use agents.\"\n          );\n        break;\n      case \"sambanova\":\n        if (!process.env.SAMBANOVA_LLM_API_KEY)\n          throw new Error(\"SambaNova API key must be provided to use agents.\");\n        break;\n      case \"lemonade\":\n        if (!process.env.LEMONADE_LLM_BASE_PATH)\n          throw new Error(\"Lemonade base path must be provided to use agents.\");\n        break;\n      case \"omlx\":","sourceCodeStart":247,"sourceCodeEnd":283,"githubUrl":"https://github.com/Mintplex-Labs/anything-llm/blob/526360e320da9d1b36074be5ed64fe76e5bbfbbd/server/utils/agents/index.js#L247-L283","documentation":"Thrown by checkSetup() (server/utils/agents/index.js:128) when the resolved agent provider is 'docker-model-runner' but process.env.DOCKER_MODEL_RUNNER_BASE_PATH is unset/empty. It is a precondition gate in agent.init() ensuring the local Docker Model Runner endpoint is configured before use.","triggerScenarios":"A chat turn calls agent.init(); this.provider resolves to 'docker-model-runner'; case 'docker-model-runner' runs and process.env.DOCKER_MODEL_RUNNER_BASE_PATH is falsy.","commonSituations":"Docker Model Runner picked as agent provider but base path never set; the endpoint URL changed; .env updated but server not restarted.","solutions":["Set DOCKER_MODEL_RUNNER_BASE_PATH in .env (e.g. http://localhost:12434/engines/llama.cpp/v1) and restart the server.","Confirm the model-runner container/service is reachable at that URL.","Switch provider if Docker Model Runner is not intended."],"exampleFix":"// before (.env)\nDOCKER_MODEL_RUNNER_BASE_PATH=\n// after (.env)\nDOCKER_MODEL_RUNNER_BASE_PATH=http://localhost:12434/engines/llama.cpp/v1","handlingStrategy":"validation","validationCode":"function assertDockerModelRunnerReady(workspaceAgentProvider) {\n  const using = workspaceAgentProvider === 'docker-model-runner' || process.env.LLM_PROVIDER === 'docker-model-runner';\n  if (using && !process.env.DOCKER_MODEL_RUNNER_BASE_PATH)\n    throw new Error('DOCKER_MODEL_RUNNER_BASE_PATH missing - set it before starting an agent.');\n}","typeGuard":null,"tryCatchPattern":"try { await agent.init(); } catch (e) { if (/Docker Model Runner base path must be provided/.test(e.message)) return showProviderConfig('docker-model-runner'); throw e; }","preventionTips":["Validate base-path providers at boot.","Restart after .env edits.","Confirm the local endpoint is reachable before enabling the provider."],"tags":["config","env","agent-provider","docker-model-runner","local-llm","agents"],"backgroundTag":null,"analyzedSha":"526360e320da9d1b36074be5ed64fe76e5bbfbbd","analyzedAt":"2026-08-13T01:45:47.170Z","schemaVersion":2},"datasetVersion":"2026-08-13T04:17:16.726Z"}