Back to Home

Docker Compose Deployment

Deploy KubeMate quickly and easily using Docker Compose. This method is ideal for development environments, small teams, or anyone who wants to get up and running with minimal configuration.

Prerequisites

Docker installed on your system

Docker Compose v2 or later

A Kubernetes cluster with valid kubeconfig

An LLM provider API key (OpenAI, Anthropic, or compatible)

Quick Start

The absolute minimum setup to start using KubeMate with Docker Compose is:

1

Clone the repository

git clone https://github.com/mehdi-chebbi/k8s-web.git
cd k8s-web
2

Copy the example environment file

cp .env.example .env
3

Edit the .env file with your configuration

Set your LLM provider API key and kubeconfig path

4

Start the application

docker-compose up -d

that's it!

Accessing KubeMate

Once the containers are running, you can access KubeMate at:

http://localhost:3000

Configuration Details

To make things even easier, the Docker Compose setup includes sensible defaults and automatic container orchestration. All data is persisted using Docker volumes, so your configuration will be preserved even if you restart the containers.

So you don't need to do anything more to start exploring your clusters right now, however take your time reading the information below to get a deeper understanding about how these concepts work.