Short answers to common questions. The link at the end of each answer has the full explanation. If you came here because of an error, Troubleshooting is faster.
Getting started
Can I use it for free?
Yes. The desktop app works right away without signing in. A signed-in account without a subscription is on the Free plan, and projects, connections, tables, code generation, and AI are unlimited on every plan. What plans change is how many people can work together and a few features. See the pricing page on the website for each plan's values and prices (Plans and features, Manage Subscription).
Should I use the web app or the desktop app?
Use the desktop app if you work with databases inside your company network, behind a VPN, or on your own PC. In the web app the NeoSQL server connects to databases, so it only reaches databases reachable from the internet. Account projects open as the same project in both apps, so you can use both (Web and desktop).
Can I use it without signing in?
Yes, in the desktop app. Without signing in you create local projects stored only on this PC. The web app requires signing in (Sign-in and project types).
Can I use it where the internet is blocked (air-gapped networks)?
Use the desktop app without signing in. Local projects, database connections, SQL, and ERDs work without internet. Signing in and account projects, getting official and public packs from the Store, automatic updates, release notes, and notices need the internet. Download the installer on a PC with internet and move it over (Install and update).
Which databases are supported?
MySQL, MariaDB, PostgreSQL, Oracle, SQL Server, SQLite, H2, Snowflake, Databricks, and BigQuery. Supabase is connected as PostgreSQL. SQLite and H2 Embedded work only in the desktop app. Feature differences by DBMS are in the Database reference.
macOS or Windows shows a warning when I install.
The macOS installer is notarized by Apple, and the Windows installer is signed by unvus Co.,Ltd. When macOS asks whether to open an app downloaded from the internet the first time, choose Open; when Windows SmartScreen warns, check that the publisher is unvus Co.,Ltd. before running it. Do not use files you got from anywhere other than the website (Install and update).
Data and security
Where is project data stored?
Local projects are stored only on this PC, with no copy on the NeoSQL server. Account projects are stored on the NeoSQL server, and each device that opens them keeps a synced copy. The data inside your databases is not stored in NeoSQL (Sign-in and project types).
Are my database passwords stored safely?
An account project's connection details are encrypted with AES-256-GCM using a key made for each project, and that key is wrapped again with an AWS KMS key. Local projects protect secret values with the operating system's secure storage (macOS Keychain, Windows DPAPI, and so on). To keep even NeoSQL operators from decrypting them, turn on zero-knowledge encryption in an account project (Security and where your data goes).
I lost my zero-knowledge secret key.
It cannot be recovered. NeoSQL does not keep the secret key. The real database and its data are untouched, so get the connection details again from whoever manages the database and enter them (Zero-knowledge encryption).
Does anything leave my PC when I am not signed in?
Only usage statistics, app version checks, release notes, notices, public pack lookups, the AI model list, and bug reports you send yourself go to the NeoSQL server. Turn usage statistics off in My page (Security and where your data goes).
Can I hide sensitive column values from teammates?
In an account project, turn on column masking for a role and that role's teammates see the values hidden. Masking only hides what is shown on screen; it does not encrypt data. To block access at the source, use database account permissions (Column masking).
Projects and collaboration
Can I turn a local project into an account project?
No. The type is set when you create the project and cannot be changed. Create a new account project, add the connections again, and bring the database's tables into an ERD again (Sign-in and project types).
How do I invite teammates?
In an account project, click the Collaborate button in the header and invite by email or nickname. On plans whose sharing capacity is one person (such as Free) the button does not appear (Sharing and members).
How do the roles differ?
The Owner role belongs to one person per project and has every permission. What the other roles (the Manager role, the DBA role, and the Member role) can actually do is decided by the permission items turned on for each role (Collaboration and permissions).
How is a workspace different from sharing a project?
A workspace shares your plan so members can create projects on it; sharing a project lets people work in that one project. Inviting someone to a workspace does not share any projects (Collaboration and permissions, Workspaces).
Teammates cannot see my localhost or SQLite connection.
That is expected. Connections that point at this PC (SQLite, H2 not in server mode, localhost or 127.0.0.1) do not point at the same database from another PC, so they become personal connections only their creator sees. To share one with the team, use an address of a server your teammates can reach (Connections and execution targets).
Databases and ERDs
The connection test fails.
Check the host and port, that the database is running, the firewall and VPN, the user and password, and whether that user may connect remotely. The web app cannot reach internal databases or localhost. Errors are listed one by one in Troubleshooting.
Can I connect over SSL, an SSH tunnel, or a proxy?
Yes. Set them on the SSL/SSH tab of the connection dialog. In an account project, SSH and proxy accounts, passwords, and private keys are stored separately for each teammate, while the SSL client certificate is stored once in the connection and shared (SSL/TLS and SSH tunnels).
Can I create an ERD from an existing database?
Yes. Drag tables from the object explorer onto the ERD canvas and the existing tables come in as they are. If you have DDL statements, you can also paste them into the Import Tables from DDL dialog (Document an existing database as an ERD).
I saved the ERD but the database did not change.
Saving only keeps it in the project. To change the database, review and run the DDL with the Apply Changes to DB... button (ERDs and the real database).
Can I export an ERD as an image or PDF?
Save it as SVG or PNG, or copy it to the clipboard as PNG. There is no direct PDF export. Images get a watermark depending on your plan and whether you are signed in (Export as image).
Can I stop dangerous SQL such as DROP or DELETE?
The SQL editor always asks once more before running TRUNCATE, DROP, or an UPDATE or DELETE without WHERE. Set the connection profile's protection mode to the Confirm (DDL + risky DML) mode to confirm DDL too, or to the Read-only (block non-SELECT) mode to refuse anything that is not a query. The surest way is a database account with fewer privileges (Safeguards for production databases).
Which languages can it generate code in?
It is not tied to any language. The files a template pack's templates produce are the result, so by changing templates you can generate code for any language or framework (Generating source code, Template syntax).
AI and MCP
What do I need to use AI?
Register an API key from an AI provider (OpenAI, Anthropic, Google, Ollama) in My page. Costs are charged to that key. In the desktop app you can also store a key on this device and use it without signing in (Providers & API Keys).
What is sent to the AI?
Your question and recent conversation, and the names and table structure of the Database and Schema you picked. Real row values are sent only when the AI runs a query, and depending on the connection you are asked to approve it first (AI and MCP).
Can I keep the AI from damaging a production database?
In the project AI settings, turn off automatic data and schema changes for each connection, and use a database account with few privileges and a protection mode for production connections (Project AI settings, Safeguards for production databases).
How do I connect an MCP client such as Claude Code?
MCP works only in the desktop app. Open a project, then in the MCP client setup dialog choose your client and copy the settings or register them directly. The settings contain no account or database passwords, and the connection works while the desktop app is running (MCP client setup). In Claude Code and in Cowork in the Claude desktop app, you can also install it as a Claude plugin (Install and connect MCP).
Account
I forgot my password.
Get a password reset email from the sign-in screen on the website and set a new one (Password).
I signed in with a social account but am asked for my email again.
If the social account does not share an email address, you enter one yourself when signing up and verify it (Sign-up and sign-in).
Can I sign out other devices too?
Signing out ends the sign-in on that device only. To end the sign-in on all other devices, change your password. Every device except the one you are using is signed out (Password). A sign-in unused for 30 days ends on its own (Sign-up and sign-in).
Related screens
- Troubleshooting: find causes by error message and symptom.
- Glossary: what the terms in the guide mean.
- Contact us: how to reach us when you cannot find an answer here.
- Introducing NeoSQL: what you do with NeoSQL.