Files
Charon/docs/features/web-ui.md
T
akanealw eec8c28fb3
Go Benchmark / Performance Regression Check (push) Has been cancelled
Cerberus Integration / Cerberus Security Stack Integration (push) Has been cancelled
Upload Coverage to Codecov / Backend Codecov Upload (push) Has been cancelled
Upload Coverage to Codecov / Frontend Codecov Upload (push) Has been cancelled
CodeQL - Analyze / CodeQL analysis (go) (push) Has been cancelled
CodeQL - Analyze / CodeQL analysis (javascript-typescript) (push) Has been cancelled
CrowdSec Integration / CrowdSec Bouncer Integration (push) Has been cancelled
Docker Build, Publish & Test / build-and-push (push) Has been cancelled
Quality Checks / Auth Route Protection Contract (push) Has been cancelled
Quality Checks / Codecov Trigger/Comment Parity Guard (push) Has been cancelled
Quality Checks / Backend (Go) (push) Has been cancelled
Quality Checks / Frontend (React) (push) Has been cancelled
Rate Limit integration / Rate Limiting Integration (push) Has been cancelled
Security Scan (PR) / Trivy Binary Scan (push) Has been cancelled
Supply Chain Verification (PR) / Verify Supply Chain (push) Has been cancelled
WAF integration / Coraza WAF Integration (push) Has been cancelled
Docker Build, Publish & Test / Security Scan PR Image (push) Has been cancelled
Repo Health Check / Repo health (push) Has been cancelled
History Rewrite Dry-Run / Dry-run preview for history rewrite (push) Has been cancelled
Prune Renovate Branches / prune (push) Has been cancelled
Renovate / renovate (push) Has been cancelled
Nightly Build & Package / sync-development-to-nightly (push) Has been cancelled
Nightly Build & Package / Trigger Nightly Validation Workflows (push) Has been cancelled
Nightly Build & Package / build-and-push-nightly (push) Has been cancelled
Nightly Build & Package / test-nightly-image (push) Has been cancelled
Nightly Build & Package / verify-nightly-supply-chain (push) Has been cancelled
Update GeoLite2 Checksum / update-checksum (push) Has been cancelled
Container Registry Prune / prune-ghcr (push) Has been cancelled
Container Registry Prune / prune-dockerhub (push) Has been cancelled
Container Registry Prune / summarize (push) Has been cancelled
Supply Chain Verification / Verify SBOM (push) Has been cancelled
Supply Chain Verification / Verify Release Artifacts (push) Has been cancelled
Supply Chain Verification / Verify Docker Image Supply Chain (push) Has been cancelled
Monitor Caddy Major Release / check-caddy-major (push) Has been cancelled
Weekly Nightly to Main Promotion / Verify Nightly Branch Health (push) Has been cancelled
Weekly Nightly to Main Promotion / Create Promotion PR (push) Has been cancelled
Weekly Nightly to Main Promotion / Trigger Missing Required Checks (push) Has been cancelled
Weekly Nightly to Main Promotion / Notify on Failure (push) Has been cancelled
Weekly Nightly to Main Promotion / Workflow Summary (push) Has been cancelled
Weekly Security Rebuild / Security Rebuild & Scan (push) Has been cancelled
changed perms
2026-04-22 18:19:14 +00:00

3.7 KiB
Executable File

title, description, category
title description category
Point & Click Management Manage your reverse proxy through an intuitive web interface core

Point & Click Management

Say goodbye to editing configuration files and memorizing commands. Charon gives you a beautiful web interface where you simply type your domain name, select your backend service, and click save.

Overview

Traditional reverse proxy configuration requires editing text files, understanding complex syntax, and reloading services. Charon replaces this workflow with an intuitive web interface that makes proxy management accessible to everyone.

Key Capabilities

  • Form-Based Configuration: Fill in fields instead of writing syntax
  • Instant Validation: Catch errors before they break your setup
  • Live Preview: See configuration changes before applying
  • One-Click Actions: Enable, disable, or delete hosts instantly

Why Use This

No Config Files Needed

  • Never edit Caddyfile, nginx.conf, or Apache configs manually
  • Changes apply immediately without service restarts
  • Syntax errors become impossible—the UI validates everything

Reduced Learning Curve

  • New team members are productive in minutes
  • No need to memorize directives or options
  • Tooltips explain each setting's purpose

Audit Trail

  • See who changed what and when
  • Roll back to previous configurations
  • Track configuration drift over time

Features

Form-Based Host Creation

Creating a new proxy host takes seconds:

  1. Click Add Host
  2. Enter domain name (e.g., app.example.com)
  3. Enter backend address (e.g., http://192.168.1.100:3000)
  4. Toggle SSL certificate option
  5. Click Save

Bulk Operations

Manage multiple hosts efficiently:

  • Bulk Enable/Disable: Select hosts and toggle status
  • Bulk Delete: Remove multiple hosts at once
  • Bulk Export: Download configurations for backup
  • Clone Host: Duplicate configuration to new domain

Search and Filter

Find hosts quickly in large deployments:

  • Search by domain name
  • Filter by status (enabled, disabled, error)
  • Filter by certificate status
  • Sort by name, creation date, or last modified

Mobile-Friendly Design

Charon's responsive interface works on any device:

  • Phone: Manage proxies from anywhere
  • Tablet: Full functionality with touch-friendly controls
  • Desktop: Complete dashboard with side-by-side panels

Dark Mode Interface

Reduce eye strain during late-night maintenance:

  • Automatic detection of system preference
  • Manual toggle in settings
  • High contrast for accessibility
  • Consistent styling across all components

Configuration

Accessing the UI

  1. Open your browser to Charon's address (default: http://localhost:81)
  2. Log in with your credentials
  3. Dashboard displays all configured hosts

Quick Actions

Action How To
Add new host Click + Add Host button
Edit host Click host row or edit icon
Enable/Disable Toggle switch in host row
Delete host Click delete icon, confirm
View logs Click host → Logs tab

Keyboard Shortcuts

Shortcut Action
Ctrl/Cmd + N New host
Ctrl/Cmd + S Save current form
Ctrl/Cmd + F Focus search
Escape Close modal/cancel

Dashboard Overview

The main dashboard provides at-a-glance status:

  • Total Hosts: Number of configured proxies
  • Active/Inactive: Hosts currently serving traffic
  • Certificate Status: SSL expiration warnings
  • Recent Activity: Latest configuration changes