docs: keyring fallback to secrets.yaml#7165
Merged
dianed-square merged 4 commits intomainfrom Feb 11, 2026
Merged
Conversation
Contributor
|
Contributor
There was a problem hiding this comment.
Pull request overview
This PR updates the documentation to reflect goose’s behavior of falling back to secrets.yaml when the system keyring cannot be accessed, and adds troubleshooting guidance for that fallback.
Changes:
- Expanded keyring-related docs to include “cannot be accessed” cases and describe file-based secret storage behavior.
- Updated troubleshooting guidance to reference automatic fallback and added a dedicated “Keyring Cannot Be Accessed (Automatic Fallback)” section.
- Updated related cross-links and references across providers, config-files, and environment-variable docs.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.
| File | Description |
|---|---|
| documentation/docs/troubleshooting/known-issues.md | Adds/updates troubleshooting guidance for keyring failures and introduces an automatic fallback section. |
| documentation/docs/guides/environment-variables.md | Updates the keyring-disable tip to include automatic fallback behavior and link to troubleshooting. |
| documentation/docs/guides/config-files.md | Clarifies when secrets.yaml is used and expands security considerations around file-based secret storage. |
| documentation/docs/getting-started/providers.md | Extends provider key storage wording to include “keyring cannot be accessed” scenarios. |
blackgirlbytes
approved these changes
Feb 11, 2026
jh-block
added a commit
that referenced
this pull request
Feb 12, 2026
* origin/main: (33 commits) fix: replace panic with proper error handling in get_tokenizer (#7175) Lifei/smoke test for developer (#7174) fix text editor view broken (#7167) docs: White label guide (#6857) Add PATH detection back to developer extension (#7161) docs: pin version in ci/cd (#7168) Desktop: - No Custom Headers field for custom OpenAI-compatible providers (#6681) feat: edit model and extensions of a recipe from GUI (#6804) feat: MCP support for agentic CLI providers (#6972) docs: keyring fallback to secrets.yaml (#7165) feat: load provider/model specified inside the recipe config (#6884) fix ask-ai bot hitting tool call limits (#7162) fix flatpak icon (#7154) [docs] Skills Marketplace UI Improvements (#7158) More no-window flags (#7122) feat: Allow overriding default bat themes using environment variables (#7140) Make the system prompt smaller (#6991) Pre release script (#7145) Spelling (#7137) feat(mcp): upgrade rmcp to 0.15.0 and advertise MCP Apps UI extension capability (#6927) ...
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR documents the new graceful keyring fallback behavior.
Documentation updates:
documentation/docs/getting-started/providers.mdanddocumentation/docs/guides/environment-variables.md:documentation/docs/guides/config-files.md:documentation/docs/troubleshooting/known-issues.md:Type of Change
AI Assistance
Testing
Some manual testing