Fixes#428: The Redis configuration doc previously listed STATIC_CONFIG as
a valid cache key, which was deprecated and causes startup errors. Added a
complete table of valid CacheKeys values with descriptions, plus a callout
warning about invalid keys.
Fixes#228: The Docker installation page had no mention of the AVX
incompatibility with Apple Silicon (M-series) Macs. Added a prominent
callout in the Prerequisites section with the docker-compose.override.yml
fix to use mongo:4.4.18.
Closes#533
Folder meta.json files listed "index" explicitly in the pages array,
causing fumadocs to include the index page twice in the flat navigation
list — once as the folder index and once as a child page. This made the
"Next" link on index/overview pages point back to themselves instead of
the first child page.
Fix: remove "index" from the pages array in all folder meta.json files.
Fumadocs automatically uses index.mdx as the folder index page without
needing it listed in pages.
Closes#523
- Add Claude to the list of supported import sources in description and body
- Add 'How to import conversations from Claude' section with step-by-step instructions
- Update wording from 'GPT chat applications' to 'AI chat applications'
- Reference Claude conversation export with thinking block support (LibreChat#11124)
* refactor: remove Nextra shims, migrate pages/ to app router, upgrade ESLint to v9
- Remove all nextra-shims and legacy pages/ directory
- Migrate subscribe, unsubscribe, and toolkit pages to app router
- Restructure config docs with guide-first setup steps and Tabs components
- Rewrite Docker install, OpenRouter, and custom endpoints docs
- Add Quick Start guide, Google Search docs, and image generation cross-links
- Update .gitignore
* feat: redesign toolkit and integrate into docs sidebar
Move credentials generator and YAML validator into the docs under
a new "Tools > Toolkit" sidebar section. Old /toolkit routes redirect
to /docs/toolkit.
Credentials generator: 2-column field grid, per-field copy buttons,
copy-all as .env block, empty state placeholder, design system tokens.
YAML validator: full-width theme-aware Ace Editor (chrome/twilight),
drag-and-drop overlay, result banners with icons, clear button,
no print margin.
Remove unused .error-marker and .custom-btn from style.css.
---------
Co-authored-by: Claude <noreply@anthropic.com>
* docs(config): rewrite overview with FileTree and restart guide
- Replace vague marketing copy with actionable config guide
- Add FileTree showing 4 config files (.env, librechat.yaml, docker-compose.yml, docker-compose.override.yml)
- Add file descriptions explaining what each config file controls
- Add restart Callout with Docker/Local tabs
- Add next-step Cards linking to librechat.yaml setup, Docker setup, .env reference
* docs(config): restructure librechat.yaml with guide-first setup steps
- Replace feature list with 4-step setup procedure using Steps component
- Add Docker/Local Tabs for deployment-specific commands
- Add OpenRouter worked example with OPENROUTER_KEY warning
- Add Reference section with Cards linking to ai_endpoints and object_structure
- Merge troubleshooting content from setup.mdx into index page
- Remove outdated model menu screenshots
* refactor(config): merge setup.mdx into librechat.yaml and add redirect
- Delete setup.mdx (content merged into index.mdx)
- Remove setup from meta.json pages array
- Update ai_endpoints link from /setup to /librechat_yaml
- Add redirect for old /setup URL in next.config.mjs
* docs(endpoints): rewrite OpenRouter as end-to-end setup guide
- Replace bare YAML snippet with 5-step Steps component guide
- Add OPENROUTER_KEY vs OPENROUTER_API_KEY warning callout
- Add Docker/Local restart Tabs and verification step
- Add customization section and reference Cards
- Remove deprecated GitHub screenshot image
* docs(setup): rewrite Docker install with first-login flow and troubleshooting
- Add Steps-based installation with clone, env, start, and verify steps
- Document first account = admin behavior at localhost:3080
- Add librechat.yaml volume mounting section with override file pattern
- Add troubleshooting for port conflicts, container crashes, missing env vars
- Replace deprecated Additional Links with Cards component for next steps
- Cross-link to librechat.yaml guide, Docker override guide, and .env reference
* docs(endpoints): add file context and activation steps to custom endpoints
- Add 'Which File Does What' callout explaining librechat.yaml, .env, and docker-compose.override.yml roles
- Rewrite Step 4 as 'Restart and Verify' with Docker/Local Tabs
- Add troubleshooting callout for missing endpoints
- Replace deprecated AdditionalLinks with Cards for next steps
- Link to Configuration Overview for file relationship context
* docs(endpoints): fix OpenRouter Step tag indentation
* fix(docs): replace empty user guides hub with Cards and remove stale screenshot
- Rewrite user_guides/index.mdx as Cards hub with Guides and Popular Features sections
- Add cross-links to Agents, Image Gen, Web Search, and MCP feature pages
- Remove stale screenshot from LiteLLM page (110412045 asset)
- Verify auth section Next button works (SAML/auth0 -> pre_configured_ai)
- Verify S3 page has all required sections (no changes needed)
* docs(features): add Quick Start guide and cross-links to image generation
* docs(tools): rewrite Google Search with agent-first Steps and cross-links
* chore: update .gitignore
* fix: make Docker/Local tabs switch content when clicked
The TabCompat wrapper was rendering <Tabs.Tab> as plain <div> elements,
which never registered with fumadocs' internal tab context. Clicking tab
triggers had no effect because the content panels didn't respond to state
changes.
Fix: assign the real fumadocs Tab component as TabsCompat.Tab via
Object.assign, so <Tabs.Tab> in MDX renders the real Tab that registers
with the parent Tabs context. Keep standalone <Tab> (from auto-generated
code blocks with filename=) as a plain div fallback to avoid crashes
when there is no parent Tabs context.
* docs: enhance mcp_servers documentation to clarify usage of customUserVars and env configuration, ensuring per-user credentials are resolved at runtime
* chore: add changelog for v0.8.4-rc1 release
Shared links now require authentication by default per LibreChat
commit 0cbf4aa. Updated dotenv docs to reflect the new default (false)
and added a Configuration section to the shareable links feature page
explaining both ALLOW_SHARED_LINKS and ALLOW_SHARED_LINKS_PUBLIC.
Co-authored-by: Claude <noreply@anthropic.com>
* ✨ v0.8.3-rc2
- Added new `document_parser` OCR strategy for local text extraction from various document formats.
- Introduced `thinkingLevel` parameter for Gemini 3+ models to control thinking effort.
- Added `reasoning_effort` parameter for Bedrock models to configure reasoning capabilities.
- Enabled document uploads for Bedrock endpoints.
- Updated default model lists to include new Gemini models.
- Changed date template variable format for improved readability.
- Updated OpenRouter reasoning configuration to align with API changes.
- Bumped configuration version to 1.3.5 across multiple documentation files.
* docs: enhance `document_parser` functionality and update OCR configuration details
- Updated the `document_parser` to run automatically for agent file uploads without requiring an `ocr` configuration, providing seamless text extraction from supported document types.
- Added fallback logic for the `document_parser` when a configured OCR strategy fails, ensuring text extraction remains effective.
- Expanded documentation to clarify the automatic operation of the `document_parser` and its limitations regarding image-based documents.
* chore: update changelog for v0.8.3-rc2
- Added new features including credential variables for DB-sourced MCP servers, updates for the `gemini-3.1-flash-lite-preview` window and pricing, and the introduction of gpt-5.3 context window and pricing.
- Enhanced agent editor functionality by allowing duplication of agents.
- Implemented fixes for OIDC logout, post-auth navigation, and URL query parameter preservation.
- Updated various dependencies and improved internationalization with new translations.
* docs: add credential variables support for UI-created MCP servers
- Introduced a new section detailing how users can provide their own API keys when adding MCP servers through the UI.
- Explained the creation of `customUserVars` for user-provided API keys and the security measures in place to prevent unauthorized access to sensitive data.
- Updated documentation to enhance clarity on the configuration process for MCP servers.
* chore: update changelog for v0.8.3-rc2
- Added new features including expanded toolkit definitions for child tools in event-driven mode and consistent Mermaid theming for inline and artifact renderers.
- Updated the Agent Tool with new SVG assets for improved visual representation.
* chore: update changelog for v1.3.5
- Updated release date to 2026-03-04.
- Adjusted date template variable format to reflect the new date and include named weekdays.
- Updated OpenRouter reasoning configuration to align with API changes.
- Changed Docker image references from `ghcr.io` to `registry.librechat.ai` in `rag_api.mdx` and `docker_linux.mdx` for consistency with the new image hosting location.
- Ensured local embeddings instructions reflect the updated image paths.
* docs: update Docker Compose installation instructions for clarity and modern syntax
* docs: update Docker Compose commands to use modern syntax
* feat: add Explore section with links to Features and User Guides in QuickStartHub
* fix: clarify description for Model Context Protocol feature
- Revised notes on the `GEMINI_VERTEX_ENABLED` option to clarify fallback behavior when no API key is set.
- Updated instructions for configuring the service account JSON file, specifying default paths and fallback mechanisms.
- Enhanced descriptions of image generation and storage integration for better user understanding.
- Introduced the `AWS_FORCE_PATH_STYLE` boolean option in the dotenv configuration, specifying its use for S3-compatible providers that require path-style URLs.
- Updated S3 configuration documentation to clarify the necessity of this option for services like MinIO and Backblaze B2, while noting it is not needed for AWS S3.
- Renamed Azure Blob Storage and Amazon S3 sections to reflect their role as file storage backends rather than CDNs.
- Enhanced descriptions to clarify that Azure Blob Storage and S3 do not serve files through a CDN, while Firebase is the only true CDN option.
- Added warnings regarding the limitations of presigned URLs for S3 and emphasized the need for stable URLs for images and avatars.
- Updated the main CDN index to better outline the differences between file storage and CDN options, improving user guidance for setup.
- Clarified the purpose of `npm run smart-reinstall` to specify it installs dependencies if the lockfile has changed and builds via Turborepo.
- Updated `npm run build` description to indicate it builds all compiled code using Turborepo with parallel and cached processes.
- Added `npm run frontend` command for sequential builds as a legacy fallback.
* chore: update documentation for project architecture, coding standards, and testing procedures
- Updated the project architecture overview to clarify monorepo structure and workspace boundaries.
- Expanded coding standards section to include detailed guidelines on workspace boundaries, code structure, iteration, performance, type safety, and documentation practices.
- Improved testing documentation by specifying how to run tests per workspace and providing clearer instructions for local unit tests.
* fix: remove outdated blog post link in Agents API documentation
- Removed the link to the blog post regarding the Open Responses decision, as it is no longer relevant. This update ensures the documentation remains concise and focused on current API frameworks.
* chore: update GitHub Actions workflow to use latest action version for improved stability
* chore: update roadmap references and enhance documentation for AWS Bedrock inference profiles
- Updated footer menu and card icons to reflect the 2026 roadmap.
- Adjusted default values in changelog and configuration documentation for `maxRecursionLimit`.
- Added comprehensive documentation for AWS Bedrock inference profiles, including setup, configuration, and examples.
- Introduced Agents API documentation for programmatic access to LibreChat agents.
- Enhanced existing documentation for clarity and consistency across various sections.
* feat: release Config v1.3.4 with new features and updates
- Introduced `create` field in `interface.prompts` and `interface.agents` for enhanced user control.
- Added `interface.remoteAgents` configuration for managing remote agent permissions.
- Updated `endpoints.bedrock` with `models` and `inferenceProfiles` for better customization.
- Included Moonshot as a known endpoint for AI integration.
- Introduced new agent capabilities: `deferred_tools` and `programmatic_tools`.
- Removed deprecated `forcePrompt` setting from configurations.
- Updated default model lists and added support for new models.
- Enhanced `modelSpecs` with `artifacts` field and `effort` parameter for Anthropic models.
* refactor: update BlogHeader to use usePathname for route handling
- Replaced useRouter with usePathname for improved routing in BlogHeader component.
- Simplified page retrieval logic by directly using pathname for matching routes.
* feat: add changelog for v0.8.3-rc1 release with new features and fixes
- Introduced several enhancements including event-driven lazy tool loading, token usage tracking, and programmatic tool calling UI.
- Added support for new models and providers, including Claude Opus 4.6 and Moonshot.
- Implemented various bug fixes and improvements for better user experience and performance.
* chore: nextjs artifact
* first draft roadmap
* feat: enhance BlogPage with Open Graph image support and layout improvements
- Added support for Open Graph images in blog entries to improve visual presentation.
- Refactored article layout for better structure and readability, including adjustments to the display of metadata and content.
- Updated styles for improved user experience during hover interactions.
* feat: enhance BlogPage with date formatting and layout adjustments
- Added a new dateFormatted field to entries for improved date display.
- Implemented a date formatter for consistent date presentation.
- Refactored article layout to use a grid system for better responsiveness.
- Updated styles for article links and metadata for enhanced user experience.
* feat: add responsive image sizes to BlogPage for improved layout
- Included sizes attribute for Open Graph images to enhance responsiveness on different screen sizes.
* feat: update feature titles and descriptions for clarity
- Changed titles for "Forking Messages and Conversations" to "Forking Chats" and "Memory" to "User Memory" for better alignment with functionality.
- Updated descriptions for "Message Search" and "Upload as Text" to enhance understanding of features.
* chore: update configuration version to 1.3.4 across multiple documentation files
- Updated the version number in `librechat.yaml` examples to reflect the latest release (1.3.4) in various configuration and feature documentation files.
* feat: enhance User Memory documentation for clarity and detail
- Updated the description to clarify that User Memory is a key/value store that operates on every chat request.
- Added a callout to distinguish between key/value storage and conversation memory.
- Expanded on the functionality of the memory agent, including its execution process and user control features.
- Introduced a section on future improvements for the memory agent's efficiency and relevance.
* feat: update title and description for NGINX documentation
- Changed the title from "Secure Deployment with Nginx" to "NGINX" for brevity.
- Updated the description to provide a clearer overview of the guide's purpose in securing LibreChat deployment with Nginx as a reverse proxy and HTTPS.
* feat: update 2026 roadmap with key accomplishments and future plans
- Celebrated LibreChat's 3rd anniversary with a summary of achievements from 2025, including growth in GitHub stars and community engagement.
- Clarified the timeline for open-sourcing the Code Interpreter API by the end of Q1.
- Revised notes on the v1 Admin Panel's core capabilities and community-driven items for better clarity and detail.
* feat: enhance blog and author components with Open Graph image support
- Added optional `ogImagePosition` field to blog entries for better image placement control.
- Updated BlogPage and individual post pages to utilize the new `ogImagePosition` for responsive image styling.
- Improved Author component to conditionally render author images based on availability.
- Updated 2026 roadmap blog post with a new Open Graph image and position for enhanced visual appeal.
* feat: enhance CardComponent with icon support and layout improvements
- Added optional `icon` prop to CardComponent for better visual representation.
- Updated CardComponent layout to include icon alongside title and children.
- Improved styling for CardComponent and CardsBase for enhanced responsiveness and user experience.
* feat: update 2026 roadmap with detailed focus areas and community-driven items
- Added sections for Q1 and Q2 focus areas, outlining major initiatives like Dynamic Context and Admin Panel.
- Enhanced clarity on community-driven items and their prioritization based on GitHub reactions.
- Included hiring information to attract full-stack developers for ongoing project support.
- Improved overall structure and readability of the roadmap content.
* fix: improve icon styling in CardCompat component for better responsiveness
- Updated icon container styling to ensure consistent height and width for SVG icons.
- Enhanced layout of CardCompat to maintain visual integrity across different screen sizes.
* chore: update .gitignore to include next-env.d.ts for TypeScript support
* fix: correct import statement formatting in next-env.d.ts for consistency
* fix: refine wording in 2026 roadmap for clarity
- Updated the description of agentic workflows to emphasize a lean approach to context pulling.
- Enhanced overall readability of the section on Dynamic Context.
* feat: expand Admin Panel section in 2026 roadmap with detailed capabilities
- Added comprehensive descriptions of the Admin Panel's core functionalities, including GUI for configuration, configuration profiles, group and role management, and access controls.
- Clarified the development approach for the Admin Panel, emphasizing ongoing iteration and community involvement.
- Updated note on the Admin Panel's prioritization and requirements following the ClickHouse acquisition.
* feat: add TrackedLink component for enhanced analytics tracking
- Introduced a new TrackedLink component that integrates Vercel analytics to track user interactions with links.
- The component allows for customizable link properties while ensuring tracking of clicks with relevant metadata.
- Updated CardCompat to utilize the new TrackedLink for improved user engagement tracking.
* feat: enhance blog post layout and introduce TrackedAnchor component for link tracking
- Wrapped the InlineTOC component in a div for improved spacing in blog posts.
- Added a new TrackedAnchor component to facilitate link tracking with Vercel analytics, allowing for customizable anchor elements.
- Updated mdx-components to utilize TrackedAnchor for enhanced link interaction tracking.
* feat: update TrackedLink and TrackedAnchor components for external link handling
- Enhanced the TrackedLink component to differentiate between internal and external links, using Next.js Link for internal navigation.
- Introduced a utility function to determine if a link is external, improving tracking accuracy.
- Updated TrackedAnchor to utilize the same external link handling logic for consistency in link tracking.
* feat: add uncaught exception handling section to dotenv configuration documentation
- Introduced a new section on uncaught exception handling, explaining how to override the default behavior to keep the app running after exceptions.
- Added an option table detailing the `CONTINUE_ON_UNCAUGHT_EXCEPTION` configuration.
- Included a warning callout advising against using this feature in production environments.
* feat: add ESLint rule for unused variables in TypeScript
- Introduced a new ESLint rule to enforce the handling of unused variables, allowing for specific patterns to be ignored.
- This enhancement aims to improve code quality by ensuring that developers are alerted to potentially unnecessary variables while maintaining flexibility in naming conventions.
* fix: update copyright year in LICENSE file to 2026
* feat: update footer menu link and add 2026 roadmap blog post
- Changed the roadmap link in the FooterMenu component to point to the new blog post.
- Introduced a new blog post detailing the 2026 roadmap for LibreChat, outlining key features and focus areas for the upcoming year.
- Updated the import statement in next-env.d.ts for consistency with the new types directory.
* fix: update import path in next-env.d.ts and add comment block in agents.mdx
- Changed the import statement in next-env.d.ts to reference the new development types directory.
- Added a comment block in agents.mdx to indicate that the Programmatic Tool Calling feature is in private beta.
* fix: remove unused ESLint disable comment in context.tsx
* chore: update blog
* feat: update table of content style in DocsPage component
* feat: add feedback widget, redesign DocsHub, and add sidebar logo
* feat: update demo images for dark and light themes
* feat: update demo images for dark and light themes
* feat: replace logo image and remove duplicate SVG file
* feat: add LocalInstallHub component and update documentation for local installation
* feat: enhance UI by updating feature icons and descriptions, and improving layout responsiveness
* Add legal pages: Cookie Policy, Privacy Policy, and Terms of Service
- Implemented Cookie Policy page with details on cookie usage and user privacy.
- Created Privacy Policy page outlining data collection practices and user rights.
- Developed Terms of Service page defining the usage terms for the documentation site.
- Removed outdated MDX files for cookie, privacy, and terms of service.
- Updated FeaturesHub component to include new feature highlights and improved layout.
* feat: enhance GitHub data fetching to include contributor count and update CommunitySection layout
* feat: enhance accessibility and improve component structure across various files
* feat: enhance components with TypeScript typings and improve documentation
- Added TypeScript interface for Screenshot component props.
- Updated button component documentation for clarity.
- Removed unnecessary console log in ContainerScroll component.
- Added descriptive comments for FloatingDock and utility functions.
- Improved CSP headers in next.config.mjs for security.
- Cleaned up package.json by removing unused dependencies.
- Refactored _app.tsx to use AppProps for type safety.
- Updated meta configuration by removing hidden display property.
- Added API documentation comments for GitHub stats and subscription endpoints.
- Enhanced error handling in subscription API.
- Updated Tailwind CSS configuration with detailed comments.
- Cleaned up style.css by organizing and refining styles.
- Updated tsconfig.json to include TypeScript files for API routes.
- Added comments to Subscriber model and dbConnect utility for clarity.
* feat: add aria-labels to HeroLinks for improved accessibility
* feat: replace Twitter icon with X and add new X icon component
* chore: update code structure for better readability and maintenance
* chore: update .gitignore to include additional AI assistant files and Claude Flow generated files
* feat: replace sidebar emojis with Lucide icons, fix duplicate titles, and clean up codebase
- Add icon resolver (lib/icons.tsx) with 73 Lucide React icons mapped to string IDs
- Wire icon resolver into Fumadocs loader for automatic sidebar icon rendering
- Update all 19 meta.json files to use icon field instead of emoji prefixes
- Add icon frontmatter to all 162 MDX documentation pages
- Deduplicate adjacent sidebar icons (e.g. Search/ListFilter, Brain/Bookmark)
- Remove duplicate H1 headings from 154 MDX files (DocsTitle renders frontmatter)
- Add frontmatter to 33 files that were missing it
- Shorten overly long titles (agents, mcp, url_query)
- Rewrite /docs/local cards from old Nextra syntax to Fumadocs Card components
- Remove all emojis from Get Started and Features index pages
- Collapse sidebar folders by default (defaultOpenLevel: 0)
- Delete temporary debugging scripts, test specs, and screenshot artifacts
- Fix eslint errors in mdx-components, nextra-shims, tailwind config, and error page
- Update .gitignore to exclude test/debug artifacts
* feat: enhance accessibility and improve UI components
- Added aria-hidden attributes to social media icons in FooterMenu for better accessibility.
- Updated FooterMenu to use <footer> element for semantic HTML.
- Improved Carousel component by adding aria-labels to navigation buttons for better screen reader support.
- Modified OptionTable to use a unique key for each row to prevent rendering issues.
- Enhanced CredentialsGeneratorBox with aria-labels for input fields and buttons to improve accessibility.
- Updated documentation to remove unnecessary links and improve clarity in various sections.
- Fixed iframe attributes in documentation for better compatibility and accessibility.
- Adjusted CSS variable for muted foreground color to improve contrast.
- Updated package.json and pnpm-lock.yaml for dependency management and optimization.
* feat: update FileComponent and FolderComponent to include new props for enhanced functionality
* Add new AI provider icons and update documentation
- Introduced new SVG icons for AI providers: TogetherAI, TrueFoundry, VLLM, Vultr, and XAI.
- Updated existing AI endpoint documentation to reflect new icon names and improve clarity.
- Replaced generic \Plug\ icons with specific provider icons for Anyscale, APIpie, Cloudflare, Cohere, Databricks, DeepSeek, Fireworks, Groq, Helicone, HuggingFace, LiteLLM, Mistral, MLX, Moonshot, NeuroChain, Ollama, OpenRouter, Perplexity, Portkey, ShuttleAI, and TrueFoundry.
- Enhanced the icon resolution logic to include new icons in the icon registry.
* feat: add DocsHub and QuickStartHub components for enhanced documentation navigation
* feat: implement FeaturesHub component for enhanced feature navigation and update ViewOptions for improved links
* feat: add fresh-build script for streamlined project setup and development
* fix: update ESLint configuration and improve type handling in components
- Added 'next.config.mjs' to ESLint ignore list.
- Refactored version assignment in ChangelogPage for better type safety.
- Removed unnecessary type casting in Author components for cleaner code.
- Simplified BlogHeader component by removing redundant type assertions.
- Added eslint-disable comments for unused variables in CardCompat and Nextra shims.
* fix: update ViewOptions link for LibreChat to remove unnecessary submit parameter
* feat: enhance HomePage layout and improve GitHub star display
- Integrated HomeLayout component for better page structure.
- Updated HeroSection to improve the presentation of GitHub stars with a new layout and styling.
- Adjusted link attributes for better accessibility and user experience.
* refactor: simplify title for Model Context Protocol (MCP) documentation
- Changed the title from "Model Context Protocol (MCP)" to "MCP" for brevity.
- Updated the description to clarify how LibreChat utilizes MCP for integration with external tools and services.
* feat: enhance navigation styling and update HomeLayout props
- Added a new background style for the navigation bar with a blur effect.
- Updated HomeLayout component to include a transparent navigation mode for improved visual integration.
* refactor: deprecate plugins in favor of agents and update related documentation
- Removed references to plugins across various files, including the FeaturesHub and documentation.
- Updated navigation redirects to point to agents instead of plugins.
- Deleted the plugins documentation file to streamline content and reduce confusion.
* feat: update demo images for improved visual representation
---------
Co-authored-by: Danny Avila <danny@librechat.ai>
