# Local Install

## Prerequisites

1. [IntelliJ](https://www.jetbrains.com/idea/) Community or Ultimate Edition (2022.3 and up are supported, though latest is recommended)
2. An application running [Java](https://www.java.com/en/) or [Kotlin](https://kotlinlang.org/) code
3. Docker installed and running - Can be either [Docker Desktop](https://www.docker.com/products/docker-desktop/), [Podman](https://podman.io/),  [Rancher Desktop](https://rancherdesktop.io/) or [Colima](https://www.google.com/search?q=colima\&rlz=1C5CHFA_enUS977US977\&oq=Colima\&gs_lcrp=EgZjaHJvbWUqBggAEEUYOzIGCAAQRRg7MgYIARBFGDsyBggCEEUYOzIHCAMQABiPAjIGCAQQRRg7MgYIBRBFGDwyBggGEEUYPDIGCAcQRRg80gEIMTUwM2owajSoAgCwAgE\&sourceid=chrome\&ie=UTF-8) 

<details>

<summary>Note to Colima Users</summary>

Please make sure to set the memory size to at least 3GB as we've had complaints of issues with memory sizes smaller than that.

```bash
colima start --memory 3
```

</details>

## 1. Install the Digma plugin in the IDE marketplace

The Digma Plugin is available on the IntelliJ Marketplace.&#x20;

<figure><img src="/files/zooKjwK3Wqi3tjq1mOR0" alt=""><figcaption></figcaption></figure>

You can install the plugin from your IDE or open the plugin [page](https://plugins.jetbrains.com/plugin/19470-digma-continuous-feedback) in your browser. &#x20;

## 2.  Setup the Digma Analytics Engine

Digma runs locally on your machine. To process all of the captured traces, analyze them, detect issues, and provide analytics, Digma relies on Docker containers. When not ingesting any traces, these containers are completely idle.

After the plugin installs you'll get to choose the preferred way to install the Digma Engine.  Several options are available:

<figure><img src="/files/IuMuJZdHSp8FcXVWill6" alt="" width="240"><figcaption></figcaption></figure>

<details>

<summary>Auto install  (Default)</summary>

This is the default option. After installation, the plugin will try to start the Digme Engine containers on your local Docker environment and will offer clear controls to allow you to `Stop` `Start` or `Remove` it.  The benefit of using this approach is that Digma will be able to also update the Engine automatically when a new release becomes available.&#x20;

![](/files/bMZpLsEr137w6xVaG4Vl)

</details>

<details>

<summary>Install Digma via Docker Compose</summary>

You can simply install Digma yourself using the Docker Compose file.&#x20;

Simply select the `Docker Compose` tab from the onboarding page and follow the instructions to download the Docker Compose file and run it locally.

![](/files/g8a2gsMq0eNXfajeh9JK)

Notice that you can use this method to deploy to other Docker platforms Both Rancher Desktop and Podman support the Docker Compose spec so you can use [Rancher Compose](https://rancher.com/docs/rancher/v1.6/en/cattle/rancher-compose/) or  [Podman Compose ](https://docs.podman.io/en/latest/markdown/podman-compose.1.html)respectively. &#x20;

</details>

<details>

<summary>Install the Docker Extension</summary>

Digma also comes bundled as a Docker Extension. If you're using Docker Desktop you can deploy the Digma Engine straight from the Docker Extensions Marketplace. The benefit is that the Engine will run in its own system space and will not create any confusion with the rest of the containers you may be running for other use cases.

You can install the Digma Extension from the Docker Marketplace or by visiting the [extension page](https://hub.docker.com/extensions/digmaai/digma-docker-extension).&#x20;

</details>

3. (Optional) If you have a product key please enter it in the configuration stage of the onboarding process along with your email

<figure><img src="/files/G1KGds6PirMCFmFZ6f20" alt=""><figcaption></figcaption></figure>

### How do I know Digma is Running?

If you've run Digma via any of the first two options, you can check that the Analytics Engine containers are up and running. In the IDE you should see both the Observability side panel and the Insights side panel showing up with no errors and waiting to receive data.

<figure><img src="/files/fGCIzNQKwEZhpB16XMIU" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: 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:

```
GET https://docs.digma.ai/digma-developer-guide/installation/readme-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.