[PR #12907] docs: clarify that custom provider IDs must be unique #14429

Open
opened 2026-02-16 18:19:13 -05:00 by yindo · 0 comments
Owner

Original Pull Request: https://github.com/anomalyco/opencode/pull/12907

State: open
Merged: No


Summary

Clarifies in the provider documentation that custom provider IDs must be unique within the config.

Problem

The docs for custom provider configuration (llama.cpp, LM Studio, Ollama) state that the provider ID "can be any string you want" without mentioning uniqueness. This is misleading when users configure multiple instances of the same provider type (e.g., multiple Ollama endpoints on different machines), as duplicate JSON keys silently override each other.

Changes

Updated 3 occurrences in providers.mdx (and the Italian translation) to read:

This can be any string you want, but each provider ID must be unique.

Related

Fixes #12900

**Original Pull Request:** https://github.com/anomalyco/opencode/pull/12907 **State:** open **Merged:** No --- ## Summary Clarifies in the provider documentation that custom provider IDs must be unique within the config. ## Problem The docs for custom provider configuration (llama.cpp, LM Studio, Ollama) state that the provider ID "can be any string you want" without mentioning uniqueness. This is misleading when users configure multiple instances of the same provider type (e.g., multiple Ollama endpoints on different machines), as duplicate JSON keys silently override each other. ## Changes Updated 3 occurrences in `providers.mdx` (and the Italian translation) to read: > This can be any string you want, **but each provider ID must be unique**. ## Related Fixes #12900
yindo added the pull-request label 2026-02-16 18:19:13 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: anomalyco/opencode#14429