Home › Knowledgebase › KB-346

How to fix and manage macOS Keychain Access 'Local Items' password prompts

Summary

This guide helps you troubleshoot and resolve: How to fix and manage macOS Keychain Access 'Local Items' password prompts. Follow the steps below to fix the issue.

Quick Tip: Need immediate assistance? 💻 Open a Ticket

Common Causes

If your Mac is repeatedly asking for your password for "Local Items" or "login" keychains, it usually indicates a synchronization mismatch between your user account password and the keychain database. This often occurs after a password change or a system update, preventing macOS from automatically unlocking your stored credentials.

Prerequisites

Before performing any of the steps below, ensure you know your current Mac login password. You will need this password to authenticate keychain resets and to unlock your new keychain. Without your current account password, you may permanently lose access to stored credentials.

Quick Fix: Resetting the Default Keychain

In most cases, the fastest way to resolve persistent prompts is to create a new default keychain, which forces the system to synchronize with your current login password.

macOS Monterey and Earlier

  1. Open Keychain Access (found in Applications > Utilities).
  2. In the menu bar at the top of the screen, select Keychain Access > Preferences....
  3. Click the button labelled Reset Default Keychains.
  4. Enter your current macOS user password when prompted and click Reset Default Keychain.
  5. Restart your Mac to ensure all background processes adopt the new keychain.

macOS Ventura and Later

On macOS Ventura, Sonoma, and later versions, the Reset Default Keychains button is no longer available in Keychain Access Settings. Instead, use the manual removal method detailed below.

Warning: Deleting the Local Items folder may cause loss of iCloud Keychain items and other synced credentials stored outside the login keychain. Before proceeding, ensure you know your current Mac login password and have a record of any critical passwords stored in iCloud Keychain, as these may not be recoverable after deletion.

Detailed Instructions: Manual Management

If you prefer not to wipe your stored passwords, you can attempt to manually synchronize the keychain or remove the corrupted local items folder.

Updating the Keychain Password

If you recently changed your Mac login password, your keychain may still be using the old one.

  1. Open Keychain Access.
  2. Right-click (or Control-click) on the login keychain in the left-hand sidebar.
  3. Select Change Password for Keychain "login".
  4. Enter your Old Password (the one used before the change) and then enter your New Password twice.
  5. Click OK.

Removing the Local Items Folder

If the "Local Items" prompt persists despite password updates, the local database may be corrupted. You can force macOS to regenerate this folder. This method applies to all macOS versions, including Ventura and later.

  1. Quit Keychain Access.
  2. Open Finder.
  3. Click the Go menu at the top of the screen, hold the Option key, and select Library.
  4. Navigate to the Keychains folder.
  5. Locate the folder with a long alphanumeric name (e.g., A2B3C4D5-E6F7...). This is your Local Items folder.
  6. Drag this folder to the Trash.
  7. Restart your Mac immediately.
macOS will automatically recreate this folder upon reboot, which often clears the synchronization error without affecting your main login keychain.

Checking iCloud Keychain Interference

If you use iCloud Keychain, synchronization between iCloud and your local keychain can cause repeated password prompts.

  1. Open System Settings (or System Preferences on older macOS versions).
  2. Select your Apple ID at the top of the sidebar.
  3. Click iCloud.
  4. Locate Passwords & Keychain or Keychain and toggle it off, then back on.
  5. Enter your Mac login password when prompted to confirm the change.
  6. Restart your Mac and check if the Local Items prompt persists.

Troubleshooting Common Issues

Prompt appears only for specific apps

If the prompt only appears when opening a specific application (like Mail or Outlook), the issue may be with a specific certificate or stored token rather than the entire keychain.

Keychain is "Locked" and won't unlock

If the keychain status shows as Locked and refuses to accept your password:

  1. Ensure your Caps Lock is off.
  2. Verify that your user account has administrative privileges.
  3. If the account was recently managed by a different organisation or MDM profile, the keychain may be encrypted with a legacy corporate password.

If these steps do not resolve the prompts, please Open a Ticket so our technicians can analyse your system logs.

Still Having Issues?

Need more help? If the issue persists after trying these steps, please open a support ticket and our team will assist you.

💻 Open a Ticket