Skip to content

Conversation

Copy link

Copilot AI commented Jan 25, 2026

📥 Pull Request

✨ Description of new changes

MSAL token cache encryption on Linux requires libsecret and a Secret Service provider. Users encountering EncryptionFailed errors had no guidance on resolving this.

Changes

  • docs/troubleshooting.md: Added Linux libsecret installation section with:

    • Package manager commands for Ubuntu/Debian, Fedora/RHEL, Arch, openSUSE, Alpine
    • Keyring daemon startup instructions
    • Verification commands and common issues table
    • Architecture documentation for future CLI automation (distro detection, dependency checking, install flow diagram)
  • src/fabric_cli/errors/auth.py: Improved encrypted_cache_error() message to include Linux-specific guidance and documentation link

  • docs/essentials/cache.md: Added platform requirements table (Windows/DPAPI, macOS/Keychain, Linux/libsecret)

Updated error message

An error occurred with the encrypted cache. On Linux, ensure libsecret is installed 
(e.g., 'sudo apt install libsecret-1-0 gnome-keyring' on Ubuntu/Debian). 
See https://aka.ms/fabric-cli for other distributions. 
Alternatively, enable plaintext fallback with 'config set encryption_fallback_enabled true'

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI and others added 2 commits January 25, 2026 13:30
…essage

Co-authored-by: ayeshurun <98805507+ayeshurun@users.noreply.github.com>
Co-authored-by: ayeshurun <98805507+ayeshurun@users.noreply.github.com>
Copilot AI changed the title [WIP] Add installation guide for libsecret dependency on Linux docs: Add libsecret installation guide for Linux and future automation architecture Jan 25, 2026
Copilot AI requested a review from ayeshurun January 25, 2026 13:32
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.

2 participants