← All extensions

Java with Eclipse JDTLS

v0.2.5 · by Yury Abykhodau, Valentine Briese · added 3 November 2026

☕️ Java language support for Zed with Eclipse JDTLS

LanguagesLanguage servers
Install in Forge SuperView the source

How to install

With Forge Super installed, the button above opens the app on this extension, where you press Install. Nothing is installed until you do.

You can also open the Extensions panel in the app and search for Java with Eclipse JDTLS. The extension's id is java-eclipse-jdtls.

Don't have Forge Super yet? Download it here.

README

From the extension's repository, written by its authors and not by Mentenaz. See the source.

zed-java-language-support-jdtls

Java language support with EclipseJDTLS for Zed.

Customizing the Behavior of the LSP

Configuring LSP Options

To configure the LSP options, you can utilize the same fields provided by VSCode's Java support documentation. These fields are documented in detail and cover a wide range of customization options. Follow these steps to configure your LSP:

  1. Open the Zed Configuration File: Open configuration file for Zed (CMD + ,). Edit the configuration to include your desired LSP options.

  2. Set Custom Options: Add the relevant fields in the configuration file to match the options provided in the VSCode Java support documentation.

  3. Specify jdk for jdtls to use JDT Language Server (jdtls) requires Java 17 or higher to run. However, if you're working on a project that uses an older version of Java (e.g., Java 8 or 11), you can still use jdtls by pointing it to a compatible Java runtime. To do this, set the java_home property in the settings section of your configuration file. This tells jdtls which JDK to use, regardless of the Java version your project is targeting.

{
  "lsp": {
    "java": {
        "java.jdt.ls.lombokSupport.enabled:": true
        "settings": {
            "java_home": "/opt/homebrew/opt/openjdk@21",
        }
    }
  }
}

Using a Custom JDTLS Binary

If you have a custom JDTLS binary that you would like to use with the Zed extension, follow these steps:

  1. Locate the JDTLS Binary: By default, the Zed extension uses the JDTLS binary located at:

    • Linux: ~/.local/share/zed/extensions/work/java-eclipse-jdtls/eclipse.jdt.ls/bin/jdtls
    • macOS: ~/Library/Application Support/Zed/extensions/work/java-eclipse-jdtls/eclipse.jdt.ls/bin/jdtls
    • Windows: %APPDATA%/Zed/extensions/work/java-eclipse-jdtls/eclipse.jdt.ls/bin/jdtls

  2. Create a Symlink: Symlink the default JDTLS binary path to your custom JDTLS binary. This ensures that when Zed starts the JDTLS, it will use your custom version.

Example for Linux:

ln -s /path/to/your/custom/jdtls ~/.local/share/zed/extensions/work/java-eclipse-jdtls/eclipse.jdt.ls/bin/jdtls