Installation Guide

This guide provides detailed instructions for installing Kite in a Kubernetes environment.

Prerequisites

• kubectl with cluster administrator privileges
• Helm v3 (recommended for Helm installation)
• MySQL/PostgreSQL database, or local storage for sqlite

Installation Methods

Method 1: Helm Chart (Recommended)

Using Helm provides flexibility for configuration and upgrades:

# Add Kite repository
helm repo add kite https://zxh326.github.io/kite

# Update repository information
helm repo update

# Install with default configuration
helm install kite kite/kite -n kite-system --create-namespace

Custom Installation

You can adjust installation parameters by customizing the values file:

For complete configuration, refer to Chart Values.

Install with custom values:

helm install kite kite/kite -n kite-system -f values.yaml

Method 2: YAML Manifest

For quick deployment, you can directly apply the official installation YAML:

kubectl apply -f https://raw.githubusercontent.com/zxh326/kite/main/deploy/install.yaml

This method will install Kite with default configuration. For advanced customization, it's recommended to use the Helm Chart.

Accessing Kite

Port Forwarding (Testing Environment)

During testing, you can quickly access Kite through port forwarding:

kubectl port-forward -n kite-system svc/kite 8080:8080

LoadBalancer Service

If the cluster supports LoadBalancer, you can directly expose the Kite service:

kubectl patch svc kite -n kite-system -p '{"spec": {"type": "LoadBalancer"}}'

Get the assigned IP:

kubectl get svc kite -n kite-system

Ingress (Recommended for Production)

For production environments, it's recommended to expose Kite through an Ingress controller with TLS enabled:

WARNING

Kite's log and web terminal features require websocket support. Some Ingress controllers may require additional configuration to handle websockets correctly.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: kite
  namespace: kite-system
spec:
  ingressClassName: nginx
  rules:
    - host: kite.example.com
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: kite
                port:
                  number: 8080
  tls:
    - hosts:
        - kite.example.com
      secretName: kite-tls

Verifying Installation

After installation, you can access the dashboard to verify that Kite is deployed successfully. The expected interface is as follows:

TIP

If you need to configure Kite through environment variables, please refer to Environment Variables.

You can complete cluster setup according to the page prompts.

Uninstalling Kite

Helm Uninstall

helm uninstall kite -n kite-system

YAML Uninstall

kubectl delete -f https://raw.githubusercontent.com/zxh326/kite/main/deploy/install.yaml

Next Steps

After Kite installation is complete, you can continue with:

• Adding Users
• Configuring RBAC
• Configuring OAuth Authentication
• Setting up Prometheus Monitoring