Chris Farhood
24033ca977
Remove all references to the incorrect `config.watchPlugins: false` requirement that was believed necessary for Headlamp v0.39.0+. Investigation revealed that plugins work correctly with the default `watchPlugins: true` setting. The earlier documentation was based on a misunderstanding of the plugin loading mechanism. Changes: - Remove watchPlugins: false from all YAML configuration examples - Remove warning sections about watchPlugins requirement - Update troubleshooting guides to focus on actual issues - Simplify installation instructions by removing unnecessary config Files updated: - README.md (main installation docs and troubleshooting table) - docs/DEPLOYMENT.md - docs/TROUBLESHOOTING.md - docs/getting-started/* (quick-start, installation, prerequisites) - docs/deployment/* (helm, production) - docs/troubleshooting/* (common-issues, README) - Multiple other doc files formatted by prettier This cleanup ensures ArtifactHub and GitHub documentation show correct, simplified installation instructions. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> Co-Authored-By: Happy <yesreply@happy.engineering>
Documentation
Central hub for Headlamp Polaris Plugin documentation.
Quick Links
Getting Started
New to the Headlamp Polaris Plugin? Start here:
- Prerequisites - System requirements, Headlamp version, Polaris installation
- Installation - Four installation methods: Plugin Manager, Sidecar, Manual, Source
- Quick Start - Get up and running in 5 minutes
User Guide
Learn how to use the plugin:
- Features - Overview dashboard, namespace views, inline audits, exemption management
- Configuration - Refresh intervals, dashboard URLs, settings
- RBAC Permissions - Required permissions, service proxy access, token-auth mode
Troubleshooting
Having issues? Check here:
- Quick Diagnosis - Quick reference table for common symptoms
- Common Issues - Detailed resolution steps for frequent problems
- RBAC Issues - Permission debugging, 403 errors, token-auth
- Network Problems - NetworkPolicies, connectivity, proxy issues
Architecture
Understand how the plugin works:
- Overview - High-level architecture, component hierarchy
- Data Flow - How data moves from Polaris to the UI
- Design Decisions - Key architectural choices and rationale
- ADRs - Architecture Decision Records
Development
Contributing to the plugin:
- Development Workflow - Setup, building, hot reload
- Testing - Unit tests, E2E tests, CI/CD
- Code Style - TypeScript, React, linting, formatting
- Release Process - Versioning, changelog, GitHub Actions
Deployment
Production deployment guides:
- Kubernetes - Direct Kubernetes manifest deployment
- Helm - Helm chart configuration, values
- Production Checklist - RBAC, NetworkPolicies, security, monitoring
API Reference
- polaris.ts - JSDoc-annotated TypeScript API (data fetching, types, utilities)
- PolarisDataContext.tsx - React Context provider for shared data
Need help? Open an issue on GitHub or check CONTRIBUTING.md for development guidelines.