Skip to content

docs: clarify OLLAMA_BASE_URL supports any Ollama-compatible server#341

Open
octo-patch wants to merge 1 commit into
plandex-ai:mainfrom
octo-patch:fix/issue-321-docker-compose-openai-compatible-docs
Open

docs: clarify OLLAMA_BASE_URL supports any Ollama-compatible server#341
octo-patch wants to merge 1 commit into
plandex-ai:mainfrom
octo-patch:fix/issue-321-docker-compose-openai-compatible-docs

Conversation

@octo-patch
Copy link
Copy Markdown

Fixes #321

Problem

The docker-compose.yml and environment-variables.md documentation implied that OLLAMA_BASE_URL is exclusively for Ollama, causing confusion for users who want to use other local inference servers like vLLM. The question "Plandex Docker compose is Ollama only?" comes from this ambiguity.

Solution

  • Added explanatory comments to docker-compose.yml clarifying that OLLAMA_BASE_URL can point to any Ollama-API-compatible server, not just Ollama (e.g. vLLM in Ollama mode, LM Studio in Ollama mode).
  • Noted that the variable can be removed/commented out if no local Ollama-compatible models are being used.
  • Noted that for non-Ollama OpenAI-compatible servers (vLLM in standard OpenAI mode), users should use the custom model providers feature instead.
  • Updated docs/docs/environment-variables.md with the same clarifications.

Testing

Documentation-only change, no functional code was modified.

The docker-compose.yml comment and environment-variables docs implied
that OLLAMA_BASE_URL was exclusively for Ollama. This caused confusion
for users wanting to use other OpenAI-compatible local inference servers
(vLLM, LM Studio, etc.) — they didn't know whether or how to adapt the
Docker compose setup.

Add comments to docker-compose.yml and update environment-variables.md
to clarify that:
- OLLAMA_BASE_URL can point to any Ollama-API-compatible server, not
  just Ollama itself (e.g. vLLM in Ollama mode, LM Studio)
- The variable can be removed when not using local Ollama-compatible models
- For non-Ollama OpenAI-compatible APIs, custom model providers should be
  used instead

Fixes plandex-ai#321
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Plandex Docker compose is Ollama only?

1 participant