Welcome to the Calíope support center. We build powerful, highly responsive database management tools with native performance. If you are experiencing an issue or have a query, browse our FAQ below or reach out directly.
✉️ Direct Support
The complete Calíope help — the same one built into the app — is published under Help, with every topic and a search box. It is worth a look before writing: most questions are already answered there.
The keyboard shortcuts are published as a sheet generated from the code, for macOS and for iPad with an external keyboard.
Experiencing an issue or need help with your purchase? Send us an email and we will get back to you, typically within 1–3 business days. For feature ideas, see Suggest a feature below.
Email: support@caliope.org- Your Operating System and version (e.g., macOS 26.1 Tahoe, iPadOS 26.1)
- Your current Calíope version (found in Calíope → About Calíope)
- A brief description of the issue and reproducible steps
- Any error messages displayed, and/or screenshots illustrating the issue
💡 Suggest a feature
Calíope grows from what its users ask for. If there's something you'd like to see — a new database engine, a workflow that would save you time, a missing language, an integration — tell us. Every request is logged on the public roadmap, and the ones that pile up the most signal are the ones we tackle next.
- Start the subject with Feature request: so we route it to the roadmap queue.
- Describe the problem you're trying to solve, not just the solution you have in mind.
- Mention how often you'd use it and on which platform (macOS, iPad, or both).
- If you've seen the feature in another tool and liked the implementation, link to it.
📊 Transparent Diagnostics & Error Reporting
In Calíope, privacy is fundamental. We do not run passive background trackers or third-party web analytics. Instead, if you switch the usage report on, Calíope keeps an open, human-readable JSON log of tool opening counters and execution errors directly on your device. It is off out of the box, and nothing is ever sent automatically. Sharing this report with us is 100% voluntary, and it directly helps us fix bugs ("pulgas") and understand community priorities.
- Open Calíope → Preferences / Settings from the main menu bar.
- Open General and scroll down to the Privacy and Diagnostics section.
- Turn on Keep a usage report on this device. It is off out of the box, so until you do this the report is empty — that is not a fault.
- Review the complete JSON report preview containing tool opening counts and event logs.
- Click Share or copy the JSON payload to attach to your email to support@caliope.org.
Frequently Asked Questions
How do I create a new database connection?
Open the Connection Manager from the sidebar or main menu bar, then click the + button. Fill in your server's host, port, username, and password.
Your credentials are stored securely using the native Keychain (macOS Security Framework) and are never transmitted to any third-party or developer servers.
How do I connect through an SSH tunnel?
In the Connection Manager, enable the SSH Tunnel toggle. Enter your SSH host, port, and username.
Calíope supports password authentication and key-based authentication (Ed25519 and ECDSA P-256/384/521). The implementation uses native SwiftNIO-SSH — no external SSH clients are needed and decrypted keys are never written to disk.
My SSL connection fails. What changed?
As of the July 2026 security hardening, Calíope verifies the server's TLS certificate by default against system trust roots. If you connect to a server with a self-signed certificate and you don't supply a CA, the connection will fail.
You have two options:
- Recommended: provide the CA certificate file in the SSL section of the profile.
- For development only: tick the "Accept untrusted certificate (insecure)" checkbox. The connection will still be encrypted but is vulnerable to man-in-the-middle attacks.
The app cannot connect to my database. What should I check?
Please perform the following quick diagnostics:
- Verify the connection host, port, username, and password are correct.
- Ensure that your MariaDB/MySQL server is configured to accept remote connections from your IP address (check the
bind-addresssetting in yourmy.cnf). - If using SSL, verify your certificates and ensure the proper SSL mode is selected.
- If behind a firewall or VPN, make sure that port 3306 (or your custom database port) is fully open.
- Isolate the issue by attempting to connect from the terminal using the command-line client
mysql -u [user] -h [host] -p.
Where is my query history stored?
Your query history is kept locally on your device in a private SQLite database. It is strictly offline by default and is never uploaded. You can browse, search, filter, and permanently delete your execution logs via the History panel inside the SQL editor.
If you opt in to iCloud query log sync, the literal query text travels to your private iCloud — Calíope shows a warning before enabling this.
How do I schedule automatic database backups?
Navigate to the Backup engine in the sidebar. Select your desired databases and tables, establish your backup schedule (daily, weekly, custom), and select the target local destination folder. Backup operations are executed locally using a non-blocking asynchronous streaming engine.
Does Calíope sync data between my devices?
Yes. Calíope offers optional iCloud synchronization for connection profiles, snippets and scheduled backups using Apple's iCloud Key-Value Store and CloudKit private database.
To preserve security, database passwords are not synced by default; Keychain entries stay on the device unless you explicitly enable iCloud Keychain sync. You can manage iCloud sync under Preferences → iCloud.
How do I delete all my data?
Open Preferences › General → Delete All My Data. One button wipes connection profiles, Keychain entries, query log, snippets, configuration and widget cache. This complies with GDPR Article 17.
Why does Calíope cost money?
Because we want Calíope to be shaped by the people who use it, and that only works if there's someone on the other end with the time to listen. We're a small team: we read and answer the email ourselves, and feature requests genuinely make it onto the work list.
The price is also what lets us not do other things. Calíope carries no ads, no trackers and no third-party analytics, and it sells nobody's data. Your usage report is a local JSON file you can read in full, and it is shared only if you choose to send it. Keeping that model running costs money, and we'd rather you paid for it than an advertiser.
If something's missing, ask for it — it's the most direct way to influence what gets built, and whatever is already underway is on the public roadmap.
And yes, some of it goes on coffee. We consider that critical infrastructure.
What happens when I request a feature?
We read it, we reply, and we log it on the public roadmap. From there two things carry weight: how many people are asking for the same thing, and whether it fits the way Calíope is built.
We can't promise that everything requested gets built — that would be a promise we couldn't keep. What we do promise is that it gets read, and that if we turn an idea down we tell you why. Write to us from Suggest a feature.
How do I use the AI SQL Assistant?
The contextual AI assistant is optional and disabled by default. To use it, navigate to Preferences → AI Assistant and supply your personal API key for OpenAI, Google Gemini or Anthropic Claude.
Only database metadata (table and column names, foreign keys) plus the prompt you type are sent to the AI API. Your row contents and credentials are never transmitted.
Is my purchase tied to my Apple ID?
Yes. Calíope is a one-time purchase handled by StoreKit 2 and the App Store: it is linked to your Apple ID and unlocks every device signed into it. The 60-day trial is a separate item priced at zero, so getting it costs nothing and asks for no card, and Calíope counts the sixty days itself, from the day you start it. Nothing renews and nothing is charged when it ends, so there is nothing to manage or cancel. It can be started only once per Apple ID.
How do I restore my purchase after reinstalling?
Open Calíope and tap or click Restore Purchases in the paywall view. The app queries the App Store to validate your purchase automatically.
The app crashes or behaves unexpectedly. What should I do?
We apologize for any inconvenience. Please try these steps:
- Completely restart Calíope.
- Verify that your operating system and Calíope are fully updated.
- If the issue continues, please reach out to us at support@caliope.org. If possible, attach any diagnostic logs or crash reports from Console.app (macOS) or Settings → Privacy & Security → Analytics & Improvements (iPadOS).
💾 Supported Databases
- MariaDB 10.2.3+, 11.x
- MySQL 5.7.5+, 8.0, 8.4 LTS
- Compatible local & cloud deployments
💻 System Requirements
- macOS: macOS 26 Tahoe or newer
- iPad: iPadOS 26 or newer
- iPhone: iOS 26 or newer
- Active internet connection for cloud/remote servers
- Calíope 1.2 remains available and supported on macOS 15 Sequoia and iPadOS 18 — the App Store installs it automatically on those systems; why the requirement.