DATARK SUPPORT
A little help.
Back to your work.
Find an answer or get help directly from the developer. For questions and feature requests, write to support@datark.app.
Troubleshooting
Start with the issue you’re seeing.
For platform features, see the Mac, iPhone and iPad comparison.
Can I try Datark without a server?
Yes. The built-in SQLite sample stays on your device and needs no server, account or network connection.
On a fresh Mac installation, open Connections and choose Open Sample Database. Select Datark Sample SQLite and connect, then open Query and run SELECT * FROM projects; to see the three example projects. You can also browse the projects and query_runs tables and the active_projects view.
On a fresh iPhone or iPad installation, Studio Sample appears in Connections automatically. Open it, choose Connect, then open Query and run SELECT * FROM users; to see the three example users. The sample also includes posts, comments and tags to explore.
Datark can't connect to my database
Check that the host and port are reachable from your device. A server on a private network may require a VPN or an SSH tunnel. To use a tunnel, add the SSH server to your database connection settings.
With TLS on, Datark verifies the server certificate and host name by default. If your server uses a certificate for a different name or a private certificate authority, choose the TLS verification mode that matches your setup in the connection settings.
SSH says a host key changed
Datark refuses a host whose key no longer matches the one saved in Known Hosts, because that can mean the connection is being intercepted. Confirm the new fingerprint with the server's administrator first. If the change is expected, replace the saved key (Mac) or remove the host in Settings, Known Hosts, and reconnect (iPhone and iPad).
Stop didn't cancel my query on the server
On PostgreSQL, outside a transaction, Datark also asks the server to cancel the running statement. A transaction-pooling proxy such as PgBouncer can prevent that cancellation from reaching the statement. During a transaction, or on other engines, Stop ends the wait in Datark while the server may still finish the statement. Check the database before running a write again.
A read-only connection refused a harmless statement
On read-only PostgreSQL, MySQL and MariaDB connections, Datark refuses any statement that names settings or functions able to switch the read-only guard off, such as set_config, transaction_read_only, dblink, lo_import or lo_export, even in a harmless read like SHOW transaction_read_only. Run that statement on a connection that is not marked read-only.
My SSH session closed on iPhone or iPad
iOS and iPadOS close SSH sessions and port forwards when Datark goes to the background. The transcript is kept, so you can scroll back through it and reconnect. If port forwards are using a session, typing exit leaves the session up and the terminal offers Retry Shell.
A SQLite or DuckDB file won't open on Mac
The Mac app is sandboxed and gets access only to the file you pick, so journal or WAL files next to it may be blocked. Read-only connections open the file read-only, which avoids creating those files. If a file still fails to open, email us with the error text.
An on-device AI model won't download
Models download from Hugging Face, so the device needs internet access and enough free storage for the model. On iPhone and iPad you can remove a downloaded model with Delete Download in Settings.
Report a problem
A few details help us reproduce the problem and get you a useful answer.
- Your setup
- Datark version, device model and OS version, database engine and server version, and any SSH tunnel or proxy.
- What happened
- The steps to reproduce it, what you expected, what happened instead, and the exact error text.
Keep your data private. Remove passwords, private keys, API keys and production data from error messages and screenshots before sending.
Opens your email app with a blank report template.
Privacy & backups
What stays private, and how to keep a reliable backup.
Privacy
Datark has no tracking or analytics, and no Datark account is required. Read the privacy policy for what is stored on your device and what the AI assistant sends.
Backups
Datark exports are for moving and sharing data, not for disaster recovery. Use engine-native tools such as pg_dump, mysqldump or the SQLite backup API for backups.
Datark is developed by Froraut.
