docker compose documentation

dashjoin/dashjoin-aas#703

Author: aeberhart

README.md

@@ -91,6 +91,7 @@ For anyone who is planning a development project, faces a tight schedule, needs
 ## Getting Started
 
 * Docker: ```docker run -p 8080:8080 -e DJ_ADMIN_PASS=djdjdj dashjoin/platform```
+* [Docker Compose](https://github.com/dashjoin/docker-compose) including out of the box AI features
 * [Download](https://download.dashjoin.com/)
 * [Playground](https://playground.dashjoin.com/)
 * [Book your fully managed PaaS tenant (Platform plus PostgreSQL)](https://dashjoin.com/#getstarted)

dashjoin-docs/docs/installation.md

@@ -147,6 +147,63 @@ If you would like to make the registered databases and credentials persistent, y
 docker run -p 8080:8080 -v PERSISTENT_FOLDER:/deployments/model dashjoin/platform
 ```
 
+## Docker Compose
+
+If you plan to use AI features, we recommend running the following containers orchestrated by Docker compose:
+
+* Platform: the main Dashjoin Platform
+* AIA: the AI Assistant
+* MCP-Proxy: Allows installing MCP tools to be used by AI Assistant
+* Postgres: the pgvector database for both platform and AIA
+
+First, clone the GitHub repository to get access to the environment:
+
+```
+git clone https://github.com/dashjoin/docker-compose
+cd docker-compose
+```
+
+### Configuring your Settings
+
+If you are running ollama (http://host.docker.internal:11434) locally, you are good to go.
+If you want to use an external AI service, please enter your API key in the .env file.
+
+The files [mcp-proxy-config.json](https://github.com/dashjoin/docker-compose/blob/main/config-docker/mcp-proxy-config.json) and [settings.yml](https://github.com/dashjoin/docker-compose/blob/main/config-docker/settings.yml) contain the default setup for your AI models and MCP servers. Usually, there is no need to make changes here. 
+
+### Starting
+
+To start, stop, and delete the setup, run these commands:
+
+```
+# start containers
+docker compose up
+
+# stop containers
+docker compose stop
+
+# delete containers
+docker compose down
+```
+
+### Volumes
+
+In your working directory, you will find a folder called "volumes". It contains the persistent volumes for the dashjoin, aia, and postgres containers.
+Note that the data is retained even after "docker compose down" is run. 
+
+### Docker MCP
+
+You can run MCP servers installed in the MCP toolkit in docker desktop. To expose them to clients, run this command:
+
+```
+source .env
+export MCP_GATEWAY_AUTH_TOKEN=${MCP_GATEWAY_AUTH_TOKEN}
+docker mcp gateway run --transport=http
+```
+
+## Kubernetes
+
+Please contact us if you are running a Kubernetes cluster and deploy workloads via helm charts.
+
 ## Run local Dashjoin installation as service
 
 If you have installed Dashjoin locally and want to run the application as a service,