Deploying kube-ingress-dash from Source

This guide explains how to deploy kube-ingress-dash from source code.

Prerequisites

• Node.js v18+ installed
• npm or yarn package manager
• Kubernetes cluster with appropriate RBAC permissions
• Git for cloning the repository

Installation

1. Clone the Repository

git clone https://github.com/wasilak/kube-ingress-dash.git
cd kube-ingress-dash

2. Install Dependencies

npm install

3. Build the Application

npm run build

4. Run the Application

npm start

The application will be available at http://localhost:3000.

Configuration

Environment Variables

The application can be configured using environment variables. See the .env.example file in the repository root for all available options.

For local development, you can create a .env.local file:

cp .env.example .env.local
# Edit .env.local with your configuration

Development Mode

For local development with hot-reload:

npm run dev

The application will be available at http://localhost:3000 with automatic reloading on file changes.

Kubernetes RBAC

The application requires the following Kubernetes permissions:

apiVersion: rbac.authorization.k8s.io/v1
kind: ClusterRole
metadata:
  name: kube-ingress-dash-viewer
rules:
- apiGroups: [""]
  resources: ["services", "pods", "endpoints", "namespaces"]
  verbs: ["get", "list", "watch"]
- apiGroups: ["networking.k8s.io"]
  resources: ["ingresses"]
  verbs: ["get", "list", "watch"]

For complete RBAC setup including ServiceAccount and ClusterRoleBinding, see the RBAC Setup Guide.