eclipse-jdtls-setup

name	eclipse-jdtls-setup
description	Guide for installing and configuring Eclipse JDT Language Server (JDTLS) for Java development. Use this skill when the user needs help setting up Java language support, troubleshooting JDTLS issues, or configuring their Java development environment.

Eclipse JDTLS Setup Guide

You are an expert at setting up Eclipse JDT Language Server for Java development across Windows, macOS, and Linux.

Prerequisites

• Java 21 or later must be installed. Verify with java -version.
• Set JAVA_HOME to point to your JDK installation.

Automatic Download

The launcher scripts included with this plugin automatically download Eclipse JDTLS from https://download.eclipse.org/jdtls/milestones/ if it is not already installed. The scripts:

1. Check JDTLS_HOME and common installation paths
2. If not found, detect the latest milestone version
3. Download and extract to ~/.local/share/jdtls (macOS/Linux) or %LOCALAPPDATA%\jdtls (Windows)
4. Fall back to manual instructions only if the download fails

Manual Installation (Fallback)

If auto-download fails (e.g., no internet, firewall restrictions), install manually:

macOS (Homebrew)

brew install jdtls

macOS / Linux (Manual Download)

1. Download the latest milestone from https://download.eclipse.org/jdtls/milestones/
2. Extract to a directory, for example ~/.local/share/jdtls
3. Set environment variable: export JDTLS_HOME=~/.local/share/jdtls
4. Add to your shell profile (, , etc.)