ArgoCD Monitor

A React + TypeScript + Vite dashboard for monitoring ArgoCD application state.

Source	epics-containers/argocd-monitor
Container	ghcr.io/epics-containers/argocd-monitor
Helm Chart	oci://ghcr.io/epics-containers/charts/argocd-monitor
Documentation	https://epics-containers.github.io/argocd-monitor
Releases	epics-containers/argocd-monitor

Features

• Real-time application health and sync status overview

• Sortable, filterable applications table

• Detailed application view with pod info, images, and age

• Pod log streaming with container selection

• Pod restart with confirmation dialog

• Automatic token refresh for uninterrupted sessions

• Light and dark theme support

Example Screenshot

Quick Start

The easiest way to run this project is using a Dev Container, which provides a fully configured development environment.

1. Clone the repository and open in VS Code:

   git clone https://github.com/epics-containers/argocd-monitor.git
   code argocd-monitor
   

2. Reopen in the Dev Container when prompted.

3. Copy .env.example to .env and set ARGOCD_AUTH_TOKEN.

4. Start the dev server:

   npm run dev
   

5. Open http://localhost:5173.

Kubernetes Deployment

Install from the OCI Helm chart registry:

helm install argocd-monitor oci://ghcr.io/epics-containers/charts/argocd-monitor \
  --set argocd.url=https://argocd.example.com \
  --set ingress.enabled=true \
  --set ingress.host=argocd-monitor.example.com

How the documentation is structured

Documentation is split into four categories, also accessible from links in the top bar.

• Tutorials
  • Installation
  • Developer Workflow

Tutorials for installation and typical usage. New users start here.

• How-to Guides
  • Configure ArgoCD Connection
  • Nginx Configuration
  • Helm Deployment
  • Keycloak Authentication

Practical step-by-step guides for the more experienced user.

• Explanations
  • Architecture
  • API and Authentication
  • Claude Code Integration
  • Project Conventions
  • CI/CD Pipeline

Explanations of how it works and why it works that way.

• Reference
  • Environment Variables

Technical reference material and release notes.