Support
Questions, bug reports and feature ideas are all welcome.
Email: ferry_api@fastmail.com
For a bug, it helps to include your Ferry version (Ferry > About Ferry), your macOS version and the steps that cause it. Please don't send real API tokens or passwords.
Common questions
Which Macs does Ferry run on?
Ferry needs macOS 26 or later, on Apple silicon or Intel.
Where are my collections saved?
Each collection is a folder of YAML files in a location you choose. Use File > Open Collection… to add an existing folder, or right-click a collection in the sidebar and choose Reveal in Finder to see where it is.
Ferry says it can't open a collection
Ferry only reads folders you've given it permission to use. If a collection folder has been moved or renamed, or its disk isn't connected, choose File > Open Collection… and select it again.
Where are secret values kept?
Variables marked as secret are stored in your macOS Keychain, not in the collection's files, so they aren't shared when you commit a collection to git. Anyone else using the collection sets their own values with Manage Environments… (Shift-Command-E).
What can I import?
OpenAPI 3.0 and 3.1 documents (YAML or JSON) and Postman collections (v2.0 and v2.1), from a file or a URL. Choose File > Import Collection… to start. Ferry shows a preview and warns about anything it can't convert before it writes any files.
Does Ferry support OAuth 2?
Not yet. For APIs that use OAuth 2 or OpenID Connect, get a token separately and use it as a bearer token, ideally in a secret environment variable.
Does Ferry collect any data?
No. See the Privacy Policy.