How to Use sqldeveloper.exe on Windows 11/10: Setup, Errors and Tips (2026)

SQL Developer EXE refers to the executable file used to launch Oracle SQL Developer on Windows. If you are trying to open SQL Developer, run it after install, fix a launch error, or understand what the EXE actually does, this guide covers all of it clearly and completely.

What Is sqldeveloper.exe?

sqldeveloper.exe is the Windows executable that starts Oracle SQL Developer. It sits inside the sqldeveloper folder of your installation and calls the Java runtime to load the application. When you double-click it or run it from the command line, it bootstraps the full SQL Developer environment including your database connections, worksheets, and settings.

Oracle SQL Developer is a free graphical tool for working with Oracle databases. You can write and run SQL queries, manage database objects, import and export data, debug PL/SQL, and much more. The EXE is simply the entry point on Windows.

There are two versions of the tool:

Version	Requires Java?	Notes
sqldeveloper with JDK bundled	No	All-in-one package, recommended
sqldeveloper without JDK	Yes	You must have JDK installed separately

Most users in 2026 should download the version that includes the JDK. It avoids a lot of common launch errors.

Where Is sqldeveloper.exe Located?

After you install or extract Oracle SQL Developer, the EXE is found at:

C:\sqldeveloper\sqldeveloper.exe

Or if you extracted it to Program Files:

C:\Program Files\sqldeveloper\sqldeveloper.exe

The exact path depends on where you placed the folder. SQL Developer does not use a traditional installer by default. Oracle distributes it as a ZIP file. You extract it and run the EXE directly. That is it.

If you downloaded the RPM or MSI variant, the install wizard handles the path for you.

How to Download sqldeveloper.exe

1. Go to the official Oracle SQL Developer download page at oracle.com/tools/downloads/sqldev-downloads.html
2. Choose the Windows 64-bit version with JDK included
3. You will need a free Oracle account to download
4. After signing in, the ZIP file downloads (roughly 500 MB to 1 GB)
5. Extract the ZIP to a folder of your choice such as C:\sqldeveloper
6. Open that folder and locate sqldeveloper.exe

Do not extract it to a path that contains spaces if you can avoid it. Some older configurations struggle with paths like C:\Program Files (x86)\Oracle Tools\sqldeveloper.

How to Run sqldeveloper.exe

Option 1: Double-click

Navigate to the sqldeveloper folder and double-click sqldeveloper.exe. The splash screen appears, then the main window loads.

Option 2: Create a desktop shortcut

Right-click sqldeveloper.exe, select Send to, then Desktop (create shortcut). Now you can open it from your desktop anytime.

Option 3: Pin to taskbar

Right-click the shortcut or the EXE and choose Pin to taskbar. Quick access from the taskbar without hunting through folders.

Option 4: Run from command line

Open Command Prompt and type:

cd C:\sqldeveloper sqldeveloper.exe

You can also pass arguments this way, which is useful for scripting or opening a specific connection.

First Launch: What to Expect

The first time you run sqldeveloper.exe, you may see:

Java path prompt: If you downloaded the version without JDK bundled, SQL Developer will ask you to point it to your Java installation. Navigate to the java.exe file inside your JDK folder, usually at C:\Program Files\Java\jdkXX\bin\java.exe.

Import settings prompt: If you had a previous version installed, SQL Developer asks if you want to import old settings. Select Yes to carry over your saved connections and preferences.

Proxy settings: If you are on a corporate network, configure proxy settings right away under Tools then Preferences then Web Browser and Proxy.

After the first launch completes, your connections and workspace are saved automatically for future sessions.

Common sqldeveloper.exe Errors and Fixes

Error: sqldeveloper.exe is not opening at all

This usually means Java is missing or the wrong version is being used.

Fix: Download the bundle that includes JDK. Extract again and try running from the new folder. This solves it in the majority of cases.

Error: “Unable to find a Java Virtual Machine”

SQL Developer cannot locate Java on your system.

Fix:

1. Open sqldeveloper\ide\bin\ide.conf in a text editor
2. Add the line: SetJavaHome C:\Program Files\Java\jdk-21
3. Replace the path with your actual JDK location
4. Save the file and relaunch sqldeveloper.exe

Error: Application hangs on splash screen

This often happens when the preferences folder from an older version conflicts with the new install.

Fix:

1. Close the application
2. Navigate to C:\Users\YourUsername\AppData\Roaming\SQL Developer
3. Rename the folder to SQL Developer_backup
4. Relaunch sqldeveloper.exe
5. It recreates fresh settings on startup

Error: “Windows protected your PC” SmartScreen warning

Windows SmartScreen may flag sqldeveloper.exe because it came from a ZIP rather than a signed installer.

Fix: Click More info, then click Run anyway. The file from Oracle’s official download is safe.

Error: sqldeveloper.exe crashes after connecting to database

This is usually a driver or connection configuration issue rather than a problem with the EXE itself.

Fix:

1. Check that you have the correct JDBC driver version for your Oracle database version
2. Go to Tools then Preferences then Database then Third Party JDBC Drivers
3. Add the ojdbc jar file that matches your database

sqldeveloper.exe Command Line Options

You can start SQL Developer from the command line with several useful arguments:

Argument	What It Does
sqldeveloper.exe /noproxy	Skips proxy configuration on startup
sqldeveloper.exe connection_name	Opens a specific saved connection
sqldeveloper.exe /reset	Resets window layout to default

These are helpful when automating SQL Developer as part of a workflow or troubleshooting display issues without touching the GUI.

How to Set sqldeveloper.exe to Always Run as Administrator

Some enterprise environments require administrator rights to connect through firewalls or access network drives.

1. Right-click sqldeveloper.exe
2. Select Properties
3. Go to the Compatibility tab
4. Check the box for Run this program as an administrator
5. Click Apply then OK

Now it always opens with elevated privileges.

Updating SQL Developer Without Losing Settings

When a new version of SQL Developer releases, you do not need to uninstall the old one. Oracle does not use a traditional installer for most distributions.

1. Download and extract the new version to a new folder such as C:\sqldeveloper-24
2. Run the new sqldeveloper.exe
3. When prompted to import settings, point it to your old version’s settings folder
4. Verify your connections carry over
5. Once satisfied, delete or archive the old folder

Your connections, snippets, and preferences transfer cleanly this way.

Performance Tips for sqldeveloper.exe

SQL Developer can feel slow on large databases or low-memory machines. These settings help:

Increase JVM memory:

Open sqldeveloper\ide\bin\ide.conf and edit:

AddVMOption -Xms256m AddVMOption -Xmx2048m

Xms is starting memory and Xmx is maximum. Increasing Xmx to 2048 or 4096 depending on your RAM makes a noticeable difference for large result sets.

Disable unused extensions:

Go to Tools then Features and uncheck extensions you do not use such as Versioning or Data Modeler if you only need SQL editing. This reduces startup time.

Close unused worksheets:

Each open worksheet consumes memory. Close tabs you are not actively using.

For a deeper dive into Oracle SQL Developer performance tuning, the Oracle SQL Developer documentation is the authoritative reference.

Differences Between sqldeveloper.exe Versions

Oracle releases updates regularly. Here is what has changed across recent versions:

Version	Key Feature Added
23.x	Improved dark mode, faster code completion
24.x	Better Git integration, updated JDK bundled
22.x	Native M1/M2 Mac support added

On Windows, the EXE behavior stays consistent across versions. The main differences are in UI features and bundled JDK versions. Always check Oracle’s release notes before upgrading in a production environment.

Running Multiple Versions of sqldeveloper.exe

Because SQL Developer does not install to the registry by default, you can run two versions side by side. Just extract them to separate folders and run each EXE independently. This is useful when testing a new version while keeping your stable version available.

Each version maintains its own settings once you point them to separate configuration directories.

Security Considerations

sqldeveloper.exe stores connection passwords in an encrypted wallet on your Windows machine at:

C:\Users\YourUsername\AppData\Roaming\SQL Developer\system\o.jdeveloper.db.connection

This wallet is tied to your Windows user account. It is reasonably secure for individual use. In shared or enterprise environments, consider using Oracle Wallet or prompting for passwords on each connection rather than saving them.

Also keep your SQL Developer version updated. Oracle patches security vulnerabilities in each release. Check Oracle’s Critical Patch Update advisories for the latest information.

Uninstalling sqldeveloper.exe

Since SQL Developer typically does not use a traditional Windows installer, uninstalling is straightforward:

1. Close SQL Developer
2. Delete the sqldeveloper folder
3. Delete the settings folder at C:\Users\YourUsername\AppData\Roaming\SQL Developer
4. Remove any desktop shortcuts you created

That is all. No registry cleanup needed in most cases.

Conclusion

sqldeveloper.exe is the starting point for Oracle SQL Developer on Windows. Download the bundled JDK version, extract the ZIP, run the EXE, and you are working with your Oracle database within minutes. Most launch problems trace back to Java configuration or a conflicting settings folder, both of which have straightforward fixes. With the right memory settings and a few tweaks, SQL Developer runs smoothly even on demanding workloads. Keep the tool updated and store your EXE in a simple path to avoid the most common issues.

Frequently Asked Questions

Is sqldeveloper.exe free to use?

Yes. Oracle SQL Developer is completely free. You do not need an Oracle Database license to download or use the tool. You only need a free Oracle account to access the download page.

Why does sqldeveloper.exe ask for a Java path on first launch?

This happens when you download the version of SQL Developer that does not include a bundled JDK. The fix is to either download the version that includes JDK, or manually point the application to your existing Java installation by editing the ide.conf file.

Can I run sqldeveloper.exe without installing anything on Windows?

Yes. The ZIP-based distribution requires no installation. Extract the ZIP and run sqldeveloper.exe directly. Nothing is written to the registry during this process. This makes it easy to use on machines where you do not have full admin rights for software installs.

How do I reset sqldeveloper.exe to default settings?

Rename or delete the folder at C:\Users\YourUsername\AppData\Roaming\SQL Developer. When you relaunch sqldeveloper.exe, it creates a fresh settings folder with default configuration. Your database connections are stored here too, so back up the folder first if you want to keep them.

What is the difference between sqldeveloper.exe and sqlplus?

sqldeveloper.exe launches Oracle SQL Developer, which is a full graphical interface for database management. SQLPlus is a command-line tool with no GUI. SQL Developer is better for visual query building, data browsing, and day-to-day development work. SQLPlus is preferred for scripting and automated tasks.