Installation

First you need a configuration files in order to configure AKHQ connections to Kafka Brokers.

Configuration file default path is /app/application.yml (for YML file), so expected to be at the same folder as AKHQ application files. Configuration file path can target any path through MICRONAUT_CONFIG_FILES environment variable, for example: MICRONAUT_CONFIG_FILES=/somepath/application.yml.

Docker

docker run -d \
    -p 8080:8080 \
    -v /tmp/application.yml:/app/application.yml \
    tchiotludo/akhq

• With -v /tmp/application.yml must be an absolute path to configuration file
• Go to http://localhost:8080

Stand Alone

• Install Java 17
• Download the latest jar on release page
• Create a configuration file
• Launch the application with java -Dmicronaut.config.files=/path/to/application.yml -jar akhq.jar
• Go to http://localhost:8080

Running in Kubernetes (using a Helm Chart)

Using Helm repository

• Add the AKHQ helm charts repository:

helm repo add akhq https://akhq.io/

• Install or upgrade

helm upgrade --install akhq akhq/akhq

Requirements

• Chart version >=0.1.1 requires Kubernetes version >=1.14
• Chart version 0.1.0 works on previous Kubernetes versions

helm install akhq akhq/akhq --version 0.1.0

Using git

• Clone the repository:

git clone https://github.com/tchiotludo/akhq && cd akhq/helm/akhq

• Update helm values located in values.yaml
  • configuration values will contains all related configuration that you can find in application.example.yml and will be store in a ConfigMap
  • secrets values will contains all sensitive configurations (with credentials) that you can find in application.example.yml and will be store in Secret
  • Both values will be merged at startup
• Apply the chart:

helm install --name=akhq-release-name  .