# Local

The recommended pattern for local deployment is to use **Docker Compose**. Check the Readme file on the CISO Assistant repo for the latest instructions.

The compose file will manage three containers and set the required variables:

* Front

* Back

* Caddy (proxy)

* Make sure to have a recent version of Docker installed
  * On a Linux distro with a server flavor, make sure to remove older versions and install the latest one using the proper Docker repos to avoid twisted setups. Check out the instructions at <https://docs.docker.com/engine/install/ubuntu/>

* On Windows, Docker Desktop+WSL is recommended

* On MacOS, Docker Desktop covers the requirements

### Using prebuilt images

Run:

```
./docker-compose.sh
```

It will clean up previous images and get the latest stable release.

Once the images are downloaded and migration triggered, you should see a prompt asking you to set the first superuser. Follow the instructions to set it, and you should be ready.&#x20;

In case you are running on an unsupported architecture, you can open a GitHub issue so that we add its support or use the next steps to build the images locally.

### Re-building the images locally

Alternatively, if the previous configuration didn't succeed, run:&#x20;

```
./docker-compose-build.sh
```

### SSL Warning

Given that Caddy is using a `self-signed certificate`, your browser will mention a warning that you can accept and continue.


---

# 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://intuitem.gitbook.io/ciso-assistant/deployment/local.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.