> ## Documentation Index
> Fetch the complete documentation index at: https://www.jetify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Eclipse IDE

## Java[​](#java "Direct link to Java")

This guide describes how to configure Eclipse to work with a devbox Java environment.

### Setting up Devbox shell[​](#setting-up-devbox-shell "Direct link to Setting up Devbox shell")

To create a devbox shell make sure to have devbox installed. If you don't have devbox installed
follow the installation guide first. Then run the following commands from the root of your project's
repo:

1. `devbox init` if you don't have a devbox.json in the root directory of your project.

2. `devbox add jdk` to make sure jdk gets installed in your devbox shell.

3. `devbox shell -- 'echo $JAVA_HOME'` to activate your devbox shell temporarily to find the path to
   your java home. Copy and save the path. It should look something like:

   ```
   /nix/store/qaf9fysymdoj19qtyg7209s83lajz65b-zulu17.34.19-ca-jdk-17.0.3
   ```

4. Open Eclipse IDE and create a new Java project if you don't have already

5. From the top menu go to Run > Run Configurations > JRE and choose **Alternate JRE:**

6. Click on **Installed JREs...** and click **Add...** in the window of Installed JREs.

7. Choose **Standard VM** as JRE Type and click Next.

8. Paste the value you copied in step 4 in **JRE HOME** and put an arbitrary name such as
   "devbox-jre" in **JRE Name** and click Finish.

9. Click **Apply and Close** in Installed JREs window. Then close Run Configurations.

Now your project in Eclipse is setup to compile and run with the same Java that is installed in your
devbox shell. Next step is to run your Java code inside Devbox.

### Setting up Eclipse Terminal[​](#setting-up-eclipse-terminal "Direct link to Setting up Eclipse Terminal")

The following steps show how to run a Java application in a devbox shell using the Eclipse terminal.
Note that most of these steps are not exclusive to Eclipse and can also be used in any Linux or
macOS terminal.

1. Press `ctrl + alt/opt + T` to open terminal window in Eclipse.

2. Navigate to the projects root directory using `cd` command.

3. Make sure `devbox.json` is present in the root directory `ls | grep devbox.json`

4. Run `devbox shell` to activate devbox shell in the terminal.

5. Use `javac` command to compile your Java project. As an example, if you have a simple hello world
   project and the directory structure such as:

   ```
   my_java_project/
   └── src/
       └── main/
           └── hello.java
   ```

   You can use the following command to compile: to compile:

   ```bash theme={null}
   javac my_java_project/src/main/hello.java
   ```

6. Use `java` command to run the compiled project. For example, to run the sample project from above:

   ```bash theme={null}
   cd src/
   java main/hello
   ```

If this guide is missing something, feel free to contribute by opening a
[pull request](https://github.com/jetify-com/devbox/pulls) in Github.

[Edit this page](https://github.com/jetify-com/docs/tree/main/docs/devbox/ide-configuration/eclipse/index.mdx)