Support
Email support@valkeyra.com. Tell us your Valkeyra version (valkeyra --version, the first line of the Valkeyra menu, or About Valkeyra), your macOS or iOS version, and what you did. Never send a key value, a backup file, your backup passphrase, or your 6 root words. We will never ask for them.
Common questions
- What do I need?
- A Mac with macOS 26 or later and Touch ID. For the iPhone app: iOS 26 or later and Face ID. iCloud Keychain on, with the same Apple Account on each device.
- Does the iPhone app work without a Mac?
- The iPhone app works together with the Valkeyra Mac app. You set up your devices on a Mac first, then join the iPhone from the Mac. After that, the iPhone can show, copy, add, and update your keys, and approve requests from your Macs.
- Why does it ask for Touch ID so often?
- Each approval is a signature by a key in your Mac's Secure Enclave, and each signature needs your finger. For
list,audit, andrun, one approval can make a short grant (10 minutes by default) for the same command in the same folder and terminal. Change the time withvalkeyra config set grant-ttl 15m(1 to 60 minutes). - Can I approve with my Mac password or the iPhone passcode?
- No. Only Touch ID or Face ID approves. This is on purpose: a person or program that knows your password still cannot approve.
- I changed my fingerprints or Face ID, and approvals stopped.
- The approver key works only with the fingers or face that were set up when it was made. If you undo the change, it works again. Otherwise, run
valkeyra devices reset-localon that Mac (it makes new keys), then follow the steps it shows. Your other devices may need to join again. - My Mac is locked or far away. Can I still approve?
- Yes, with the iPhone app or another Mac in your devices. The request shows on the iPhone; approve with Face ID.
- During a Focus, I get no request alert on the iPhone.
- In Settings > Focus, allow Valkeyra in each Focus mode.
- I lost my iPhone.
- On a Mac, remove the iPhone from your devices. Its approver key then stops working. Your keys were in its keychain, so rotate the keys that matter (make new ones at each provider).
- How do I move to a new Mac?
- Install Valkeyra on the new Mac. In the "Set up Valkeyra" window, choose "Join Your Roster…", and approve on a Mac that is already set up. Your keys come through iCloud Keychain.
- How do I back up my keys?
- Use Backup in the Keys window or
valkeyra export <file>(the passphrase goes in the Valkeyra panel, never in the terminal). Use a passphrase of at least 6 words, or 24 characters or more (Valkeyra refuses fewer than 16 characters), and keep it away from the place where you keep the file. Valkeyra refuses to write a backup into a project folder or a git repository. - I deleted a key by mistake.
- Deleted keys go to the Trash for 30 days. Restore it from the Trash in the Keys window, or with
valkeyra trash restore <name>. Afterset --replace, the value before it is kept for 30 days:valkeyra previous restore <name>. - My coding agent says it cannot run a
valkeyracommand. - That is the rules working. Some commands (
set,delete,reveal,export,import,config,devices, and others) are only for you. Run them yourself in Terminal. See Use Valkeyra with coding agents. - How do I remove Valkeyra?
- See Remove on the download page.
Security issues
If you think you found a security problem, email security@valkeyra.com with the details. Do not include real keys. We answer within 7 days.
Known limits
See Limits.