> For the complete documentation index, see [llms.txt](https://academy.pentaho.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.pentaho.com/getting-started/start-here/developer-edition.md).
# Install Developer Edition
**Pentaho Developer Edition runs on your own machine for 15 days. Use it to work through workshops at your own pace, or to prototype against your own data.**
***
{% stepper %}
{% step %}
#### Check prerequisites
Confirm your machine is ready before you download. Developer Edition runs on Windows and macOS.
Requirement
Operating system
Windows 11, or macOS 15 (Sequoia) / 14 (Sonoma) — Intel and Apple Silicon (M1, M2, M3)
Java
Java 21 (certified) or Java 17 (supported) — Oracle JDK, OpenJDK, Temurin or Azul Zulu builds
Disk space
50 GB free after installation
Memory
16 GB RAM dedicated to PDI
Check your Java version first — this is where most installs go wrong:
{% tabs %}
{% tab title="Windows (PowerShell)" %}
```powershell
java -version
```
{% endtab %}
{% tab title="macOS" %}
```bash
java -version
```
{% endtab %}
{% endtabs %}
{% hint style="warning" %}
On Windows, install to a path with **no spaces in it**. `C:\Pentaho\design-tools` works; `C:\Program Files\Pentaho` causes problems later.
{% endhint %}
{% endstep %}
{% step %}
#### Download Developer Edition
The download is a single archive. Save it somewhere you can find it — you'll extract it in the next step.
Your 15 days start from REPLACE-ME (first launch / download date — confirm which).
{% endstep %}
{% step %}
#### Install Directory
{% tabs %}
{% tab title="Windows (Powershell)" %}
1. Create the following directory: `C:\Pentaho\design-tools`
2. Extract the archive to `C:\Pentaho\design-tools`.
3. Open the `design-tools\data-integration` folder.
4. Run `spoon.bat`.
{% endtab %}
{% tab title="macOS" %}
1. Extract the archive to `~/Pentaho`.
2. Open the `design-tools/data-integration` folder.
3. Open **Data Integration.app**.
Because the app comes from outside the App Store, macOS may block the first launch — right-click **Data Integration.app** and choose **Open** the first time.
{% endtab %}
{% endtabs %}
The first launch takes longer than later ones while plugins load.
#### Or command launch
Launch the Data Integration client and confirm it opens.
{% tabs %}
{% tab title="Windows (PowerShell)" %}
```powershell
Set-Location C:\Pentaho\design-tools\data-integration; .\spoon.bat
```
{% endtab %}
{% tab title="macOS" %}
```bash
cd ~/Pentaho/design-tools/data-integration
open "Data Integration.app"
```
{% endtab %}
{% endtabs %}
You should see the Spoon welcome screen. If you do, you're ready.
{% endstep %}
{% step %}
#### Download the workshops and start
Workshops come as a bundle of transformations, jobs, sample data, and setup scripts. Download the bundle, extract it, and open the first transformation in Spoon.
Browse all Data Integration workshops
{% endstep %}
{% endstepper %}
***
## What Developer Edition doesn't include
Developer Edition covers the core data integration and analytics capability. Enterprise Edition adds features you'll need for a production evaluation — enterprise security and access control, the full server-side platform, scheduling and orchestration at scale, and Pentaho support.
If you're evaluating for your organisation rather than learning, the Enterprise trial is the better fit.
***
## If something goes wrong
{% hint style="warning" icon="life-ring" %}
Spoon won't start, or closes immediately
Almost always Java. Run `java -version` and confirm it matches the requirement above. If you have several JDKs installed, set `JAVA_HOME` explicitly to the supported one before launching. On Windows, also check your install path has no spaces in it.
macOS says the app can't be opened, or is from an unidentified developer
That's macOS Gatekeeper checking an app installed from outside the App Store. Right-click **Data Integration.app** and choose **Open**, then confirm — you only need to do this once. If it's still blocked, go to **System Settings → Privacy & Security** and choose **Open Anyway** next to the blocked-app message.
My 15 days have run out
Developer Edition can't be extended. If you're still evaluating, [request an Enterprise Edition trial](https://academy.pentaho.com/getting-started/start-here/enterprise-trial) — an AE can set a trial period that matches what you're actually trying to prove.
I can't install software on this machine
Use the [browser lab](https://academy.pentaho.com/getting-started/start-here/evaluate-online) instead. It runs entirely in a tab, with nothing to install.
{% endhint %}
{% hint style="warning" icon="life-ring" %}
**Need help?**
Press Ctrl + K and click **Ask** to search every page on this site, or email .
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://academy.pentaho.com/getting-started/start-here/developer-edition.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.