BoltAI Documentation
HomepagePricingChangelogDownload
  • Overview
  • Features
  • License
  • Getting Started
    • Setup
    • Your First Chat
    • AI Command
    • AI Inline
    • Use another AI Service
  • Chat UI
    • Overview
    • Basic Chat
    • Document Analysis
    • Advanced Voice Mode (beta)
    • Image Generation
    • Chat Configuration
    • AI Assistant
    • AI Plugins
    • App Appearance
    • Folder & Sidebar
    • Keyboard Shortcuts
    • Import from ChatGPT
    • Import from Claude.ai
    • Import / Export
    • Database Maintenance
    • Locations
    • Feature Flags
    • Community Icon
  • AI Command
    • Overview
    • Customize an AI Command
    • Alternative Profile
    • AI Command Behaviors
    • Instant Command
    • Bulk Editing Commands
    • FAQs
  • AI Inline
    • Overview
    • Inline Assistant
    • Inline Prompt
    • Inline Whisper
    • Advanced Configurations
  • Plugin
    • Overview
    • MCP Servers
    • Google Search
    • Web Browsing
    • Memory
    • Perplexity Search
    • Kagi Search
    • Brave Search
    • You.com Search
    • AppleScript
    • Shell Access
    • FFmpeg
    • DALLĀ·E
    • Replicate
    • Whisper
    • Whisper (via Groq)
    • WolframAlpha
    • Gemini Code Execution
  • BoltAI on Setapp
    • Setapp Limitation
    • AI Inline on Setapp
    • Troubleshooting
  • BoltAI Mobile
    • Getting Started
    • MCP Servers (mobile)
  • Guides
    • How to create an OpenAI API Key
    • How to setup Web Search Plugin for BoltAI
    • How to set up BoltAI without an OpenAI API Key
    • How to generate Azure OpenAI API key
    • How to use Azure OpenAI API key in BoltAI
    • How to create an OpenRouter API key
    • How to set up a custom OpenAI-compatible Server in BoltAI
    • How to use Mistral AI on macOS with BoltAI
    • How to use Perplexity AI on mac with BoltAI
    • How to use Anthropic Claude on macOS with BoltAI
    • How to use Replicate AI on macOS with BoltAI
    • How to use Jina DeepSearch with BoltAI
    • How to migrate data to another Mac
    • How to back up your database
    • Cloud Sync Workaround
  • Troubleshooting
    • How to fix "This license key has reached the activation limit"
    • How to fix "You exceeded your current quota, please check your plan and billing details"
    • How to fix Accessbility permission
    • How to completely uninstall BoltAI
    • Can't select text in conversation prompt
    • API keys not persisted?
    • Download Previous Versions
  • Company
    • Run by a human
Powered by GitBook
On this page
  • How to re-grant BoltAI keychain access?
  • What is Keychain?
  • Notes:

Was this helpful?

  1. Troubleshooting

API keys not persisted?

PreviousCan't select text in conversation promptNextDownload Previous Versions

Last updated 7 months ago

Was this helpful?

If your API keys are not persisted between app launches, it's likely that BoltAI wasn't able to access Apple Keychain. Follow this guide to grant BoltAI the permission.

How to re-grant BoltAI keychain access?

  1. Go to the Keychain Access app on your Mac. To open Keychain Access, search for it in Spotlight, then press Return.

  2. Select "login" keychain. Search for the key BoltAI_openAIKey (screenshot 1)

  3. Open the password entry. Select tab "Access Control" (screenshot 2)

  4. Click the + Plus button and select the BoltAI app.

  5. Click "Save Changes" and restart BoltAI.

What is Keychain?

Keychain Access is a password management system used in Apple’s macOS and iOS operating systems. It securely stores and manages passwords, encryption keys, certificates, and sensitive data for applications and websites. Apple uses Keychain to allow users and apps to securely store credentials like passwords and tokens without requiring the user to manually re-enter them every time.

Why Keychain Access is More Secure

  1. Encryption: All data stored in the Keychain is encrypted using strong encryption algorithms (AES-256). Only authorized apps or services can decrypt and access the stored data, ensuring that sensitive information is protected even if the device is compromised.

  2. Access Control: Keychain restricts access to items using Access Control Lists (ACLs), allowing the owner to specify which applications or processes are permitted to access a given Keychain item. The user must authorize access through Face ID, Touch ID, or a password.

  3. Hardware Integration: On devices with a Secure Enclave (like iPhones and newer Macs), the encryption keys for the Keychain are stored in this secure hardware, which is isolated from the rest of the system. This makes it incredibly difficult for attackers to access the keys, even if they have physical access to the device.

  4. User Prompts for Sensitive Data: When an application requests access to a Keychain item, the system prompts the user for consent (e.g., Face ID, Touch ID, or password). This ensures that unauthorized apps cannot silently retrieve data without user awareness.

  5. Protection Across Multiple Devices: On macOS and iOS, Keychain data can be synced across devices using iCloud Keychain. This ensures that even sensitive credentials can be accessed on multiple trusted devices securely.

Notes:

MacOS may occasionally asks you if BoltAI can access secure data in your Keychain. Always click accept. Otherwise, BoltAI won't be able to persist your API keys.

BoltAI stores your API key securely in Apple Keychain
Always allow BoltAI to access this password entry
Always Allow BoltAI to access your keychain