Support

Getting Help

We're here to help you get the most out of D1Explorer. Below you'll find answers to common questions and ways to reach us.

Common Questions

How do I connect to my Cloudflare D1 database?

You'll need a Cloudflare API token with D1 read/write permissions. In the App, go to Settings and add your Cloudflare account with your API token. Your databases will appear automatically once authenticated.

Cost & Budget says my token can't read analytics

Cost & Budget reads your usage from Cloudflare's analytics API, which needs a permission that a D1-only token does not carry. Edit the token in the Cloudflare dashboard, add Account > Account Analytics > Read alongside your existing D1 permission, then update the token on that connection in Settings. Everything else in the app works without it.

Which API token permissions does D1Explorer need?

Different features need different permissions, and no single Cloudflare token template covers all of them. Rather than guess, open Connection Doctor from the toolbar or by right-clicking a connection in the sidebar — it probes each capability live and tells you exactly which permission is missing.

• Account > D1 > Read — browsing tables, viewing schema, and running SELECT queries. This is the minimum for a connection to work at all.
• Account > D1 > Edit — editing rows, creating and altering tables, running write queries, Export Snapshot, and Time Travel restore in the Recovery Center.
• Account > Account Analytics > Read — Cost & Budget. This is the one people miss, because a D1 token template does not include it.

A token missing a permission never breaks the rest of the app: the affected feature explains what to add, and everything else keeps working.

Where are my API tokens stored?

All API tokens are stored securely in the macOS Keychain. They are never sent to our servers or any third party — only to Cloudflare's API endpoints.

The App cannot connect to Cloudflare

Please verify the following:

• Your API token is valid and has not expired
• Your token has the required D1 permissions (Account > D1 > Edit), plus Account > Account Analytics > Read if you use Cost & Budget
• Your internet connection is working
• Cloudflare's API is not experiencing an outage — check Cloudflare Status

How do I open a local SQLite file?

Use File → Open or drag and drop a .sqlite / .db file directly into the App window. The file will be opened in read-write mode.

Can I use D1Explorer offline?

Yes — you can work with local SQLite files without an internet connection. Cloudflare D1 databases require an active connection to Cloudflare's API.

System Requirements

• macOS 26.0 or later
• Apple Silicon or Intel Mac
• Internet connection for Cloudflare D1 features

Useful Links

• D1Explorer support repository on GitHub
• Cloudflare D1 Documentation
• How to create a Cloudflare API token

Report an Issue

Found a bug or have a feature request? Open an issue on GitHub — the link below opens a new issue pre-filled with a template so we can help faster.

Contact Us

Prefer email? Reach out to us directly: