Features¶
Charon makes managing your web applications simple. No command lines, no config filesβjust a clean interface that lets you focus on what matters: running your apps.
π― Core Features¶
π― 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. If you can browse the web, you can manage a reverse proxy.
Whether you're setting up your first website or managing dozens of services, everything happens through intuitive forms and buttons. No terminal required.
β Learn More
ποΈ Proxy Host Groups¶
Keep a large list of sites tidy by organizing your proxy hosts into groups. Drag and drop hosts between groups on the Proxy Hosts page, assign a group to several hosts at once, or just pick a group right from a host's create/edit form β whichever is quickest in the moment.
βͺοΈ Redirection Hosts¶
Moved your site to a new domain, or retired an old one? Set up a Redirection Host to send visitors from an old address straight to the new one, with a proper HTTP redirect β no backend server, no dead links. Pick a status code (301, 302, 307, or 308), decide whether the original page/path should carry over, and Charon handles the SSL certificate for the old domain just like it would for a Proxy Host.
β Learn More
π Automatic HTTPS Certificates¶
Every website deserves the green padlock. Charon automatically obtains free SSL certificates from Let's Encrypt or ZeroSSL, installs them, and renews them before they expireβall without you lifting a finger.
Your visitors get secure connections, search engines reward you with better rankings, and you never have to think about certificate management again.
β Learn More
π DNS Challenge for Wildcard Certificates¶
Need to secure *.example.com with a single certificate? Charon now supports DNS challenge authentication, letting you obtain wildcard certificates that cover all your subdomains at once.
Supported Providers:
- Cloudflare, AWS Route 53, DigitalOcean, Google Cloud DNS, Azure DNS
- Namecheap, GoDaddy, Hetzner, Vultr, DNSimple
Charon checks the addresses you enter for DNS providers and refuses ones that point back at the Charon host itself or at cloud-internal addresses.
Your credentials are stored securely with encryption and automatic key rotation. More providers are on the roadmap β see the DNS Providers Guide for details.
β Learn More
π Cerberus Security Suite¶
Enterprise-grade protection that "just works." Cerberus bundles multiple security layers into one easy-to-manage system.
π How Charon Keeps You Safe¶
Curious what's actually protecting your server, and why? From automatic HTTPS and encrypted secrets to CrowdSec's neighborhood-watch threat detection and login protection that slows down password guessing, this page walks through Charon's security philosophy in plain language β no jargon required.
β Learn More
π¦ Login Protection¶
Charon slows down repeated sign-in attempts automatically, so password guessing gets nowhere. It's on by default with nothing to set up, and administrators can check its status on the Security page.
β Learn More Β· Trusted Proxies
π§ Trusted Proxies¶
Charon trusts only the proxies you list, so it sees your visitors' real addresses and no one can fake them. Add your proxy on the Security page.
β Learn More
ποΈ Security Dashboard Toggles¶
Control your security modules with a single click. The Security Dashboard provides instant toggles for each security layer:
- ACL Toggle β Enable/disable Access Control Lists without editing config files
- WAF Toggle β Turn the Web Application Firewall on/off in real-time
- Rate Limiting Toggle β Activate or deactivate request rate limits instantly
Key Features:
- Instant Updates β Changes take effect immediately with automatic Caddy config reload
- Persistent State β Toggle settings persist across page reloads and container restarts
- Optimistic UI β Toggle changes reflect instantly with automatic rollback on failure
- Performance Optimized β 60-second cache layer minimizes database queries in middleware
π΅οΈ CrowdSec Integration¶
Protect your applications using behavior-based threat detection powered by a global community of security data. Bad actors get blocked automatically before they can cause harm.
Preset changes are backed up first and rolled back automatically if anything goes wrong, and CrowdSec's downloaded data now survives container recreation.
The CrowdSec file editor no longer lists CrowdSec's account and connection credential files, and backups are shown by name.
β Learn More β’ Setup Guide
π CrowdSec Dashboard¶
See your security posture at a glance. The CrowdSec Dashboard shows attack trends, active bans, top offenders, and scenario breakdownsβall from within Charon's Security section.
Highlights:
- Summary Cards β Total bans, active bans, unique IPs, and top scenario at a glance
- Interactive Charts β Ban timeline, top attacking IPs, and attack type breakdown
- Alerts Feed β Live view of CrowdSec alerts with pagination
- Time Range Selector β Filter data by 1 hour, 6 hours, 24 hours, 7 days, or 30 days
- Export β Download decisions as CSV or JSON for external analysis
No SSH required. No CLI commands. Just open the Dashboard tab and see what's happening.
β Learn More
π Access Control Lists (ACLs)¶
Define exactly who can access what. Block specific countries, allow only certain IP ranges, or require authentication for sensitive applications. Fine-grained rules give you complete control.
-
Management access: Choose which lists protect Charon's own interface, separately from your websites.
-
Country database card: Admins can check, reload, or replace the country map from the Security page, without using a terminal.
β Learn More
π§± Web Application Firewall (WAF)¶
Stop common attacks like SQL injection, cross-site scripting (XSS), and path traversal before they reach your applications. Powered by Coraza, the WAF protects your apps from the OWASP Top 10 vulnerabilities.
β Learn More
β±οΈ Rate Limiting¶
Prevent abuse by limiting how many requests a user or IP address can make. Stop brute-force attacks, API abuse, and resource exhaustion with simple, configurable limits.
β Learn More
οΏ½οΈ Development & Security Tools¶
π GORM Security Scanner¶
Automated static analysis that detects GORM security issues and common mistakes before they reach production. The scanner identifies ID leak vulnerabilities, exposed secrets, and enforces GORM best practices.
Key Features:
- 6 Detection Patterns β ID leaks, exposed secrets, DTO embedding issues, and more
- 3 Operating Modes β Report, check, and enforce modes for different workflows
- Fast Performance β Scans entire codebase in 2.1 seconds
- Zero False Positives β Smart GORM model detection prevents incorrect warnings
- Lefthook Integration β Catches issues before they're committed
- VS Code Task β Run security scans from the Command Palette
Detects:
- Numeric ID exposure in JSON (
json:"id"onuint/intfields) - Exposed API keys, tokens, and passwords
- Response DTOs that inherit model ID fields
- Missing primary key tags and foreign key indexes
Usage:
# Run via VS Code: Command Palette β "Lint: GORM Security Scan"
# Or via lefthook:
lefthook run pre-commit
β‘ Optimized CI Pipelines¶
Time is valuable. Charon's development workflows are tuned for efficiency, ensuring that security verifications only run when valid artifacts exist.
- Smart Triggers β Supply chain checks wait for successful builds
- Zero Redundancy β Eliminates wasted runs on push/PR events
- Stable Feedback β Reduces false negatives for contributors
οΏ½π‘οΈ Security & Headers¶
π‘οΈ HTTP Security Headers¶
Modern browsers expect specific security headers to protect your users. Charon automatically adds industry-standard headers including:
- Content-Security-Policy (CSP) β Prevents code injection attacks
- Strict-Transport-Security (HSTS) β Enforces HTTPS connections
- X-Frame-Options β Stops clickjacking attacks
- X-Content-Type-Options β Prevents MIME-type sniffing
One toggle gives your application the same security posture as major websites.
β Learn More
π Smart Proxy Headers¶
Your backend applications need to know the real client IP address, not Charon's. Standard headers like X-Real-IP, X-Forwarded-For, and X-Forwarded-Proto are added automatically, ensuring accurate logging and proper HTTPS enforcement.
β Learn More
π³ Docker & Integration¶
π³ Docker Auto-Discovery¶
Already running apps in Docker? Charon automatically finds your containers and offers one-click proxy setup. No manual configuration, no port huntingβjust select a container and go.
Connect Docker with Orthrus (recommended: a small helper holds the Docker socket so Charon never does), or mount the Docker socket directly (still fully supported). Works for Docker on the same machine or on other machines, perfect for managing multiple machines from a single dashboard. If no socket is mounted, the "Local (Docker Socket)" choice in the Proxy Host form is greyed out.
β Learn More
Orthrus β Remote Tunnel Agent¶
Your HomeLab is behind a firewall? Orthrus is a small agent you install on any remote machine. It dials outward to Charon over a secure connection β no open inbound ports required. Once connected, Charon can discover and proxy Docker containers on that machine just like local ones. The agent runs as a low-privilege user, not as the machine's administrator.
β Learn More
οΏ½π Hecate Tunnel & Pathway Manager¶
Connect servers that sit behind firewalls or NAT routersβno open inbound ports required. Choose how each Source reaches Charon from three simple connection modes, all managed from the Sources page.
Connection Modes:
- Direct β Type in a hostname or IP address manually
- Agent β Pick an Orthrus agent; Charon figures out the address automatically based on the agent's network assignment
- Provider β Pick a VPN/tunnel network and a specific device on it directly, without needing an agent
Provider Management:
Each tunnel provider (Tailscale, Cloudflare, NetBird, ZeroTier) shows its configured tunnels directly on the provider card. Click the settings icon next to any tunnel to edit it without leaving the page.
Orthrus Agent + Provider Assignment:
Each Orthrus agent can be assigned a provider tunnel and a specific device (or public hostname for Cloudflare). Once assigned, Charon remembers the addressβso when you add a Source using that agent, the connection details fill in automatically.
A step-by-step install wizard walks you through deploying the Orthrus agent (Docker Compose or Kubernetes). Each Source shows a live status badge so you can see connection health at a glance.
β Learn More
οΏ½π₯ Caddyfile Import¶
Migrating from another Caddy setup? Import your existing Caddyfile configurations with one click. Your existing work transfers seamlesslyβno need to start from scratch.
β Learn More
οΏ½ Nginx Proxy Manager Import¶
Migrating from Nginx Proxy Manager? Import your proxy host configurations directly from NPM export files. Charon parses your domains, upstream servers, SSL settings, and access lists, giving you a preview before committing.
π JSON Configuration Import¶
Import configurations from generic JSON exports or Charon backup files. Supports both Charon's native export format and Nginx Proxy Manager format with automatic detection. Perfect for restoring backups or migrating between Charon instances.
οΏ½π WebSocket Support¶
Real-time applications like chat servers, live dashboards, and collaborative tools work out of the box. Charon handles WebSocket connections automatically with no special configuration needed.
β Learn More
π Monitoring & Observability¶
π Uptime Monitoring¶
Know immediately when something goes wrong. Charon continuously monitors your applications and alerts you when a service becomes unavailable. Give each monitor its own check interval, view uptime history and response times at a glance, and let old check history clean itself up automatically on a retention window you choose.
β Learn More
For contributors: how the uptime summary queries behave on large installs is measured in Database performance.
ποΈ Automatic Database Maintenance¶
Charon keeps its database small on its own. An older database with a lot of wasted space is optimized automatically at startup, only when it is worthwhile, and your proxies keep running meanwhile. The Database page under Tasks shows the size and, if you like, lets you ask for it at the next restart.
β Learn More
π Real-Time Logs¶
Watch requests flow through your proxy in real-time. Filter by domain, status code, or time range to troubleshoot issues quickly. All the visibility you need without diving into container logs. Need to look back? The Log Viewer on the Tasks β Logs page lets you browse saved log files β click any column header to sort them, and download a file with one click.
β Learn More
π Dashboard Statistics¶
See exactly how your sites are performing β right from the home screen. The Dashboard Statistics section shows request counts, which of your sites are busiest, how your traffic breaks down by response type, and a heads-up when any SSL certificate is getting close to its expiry date.
Highlights:
- Live updates β Charts refresh automatically as new traffic arrives; no manual refresh needed
- Traffic overview β Total requests over the last 24 hours, 7 days, and 30 days
- Top sites β Ranked list of your busiest proxy hosts
- Response health β Breakdown of successful responses versus errors at a glance
- Cert expiry warnings β See which certificates are expiring soon before visitors notice
- Service health β A single indicator showing whether stats collection is running normally
- Privacy-safe β Visitor IP addresses are never stored; only an anonymized fingerprint is kept
π Notifications¶
Get alerted when it matters. Charon sends notifications through Discord, Gotify, Ntfy, Pushover, Slack, Telegram, Email, Custom Webhook, and Web Push providers. Choose a built-in JSON template or write your own to control exactly what your alerts look like, or turn on Web Push for alerts that land right on your phone or computer β no extra app required.
β Learn More
π οΈ Administration¶
π₯ User Accounts & Roles¶
Charon has administrators, who can change anything, and standard users, who manage proxy hosts and can view most settings but can't touch security-sensitive configuration. There's no public sign-up page β an admin adds every account, by email invite or directly, and the first administrator is created during initial setup.
β Learn More
πΎ Backup & Restore¶
Your configuration is valuable. Charon makes it easy to backup your entire setup and restore it when neededβwhether you're migrating to new hardware or recovering from a problem. Backups include a validated, checksummed archive format, configurable scheduling, optional passphrase encryption, and automatic copies to S3, SFTP, WebDAV, Dropbox, or Google Drive.
β Learn More β’ Connecting Dropbox/Google Drive β’ Disaster Recovery Guide
β‘ Zero-Downtime Updates¶
Make changes without interrupting your users. Update domains, modify security rules, or add new services instantly. Your sites stay up while you workβno container restarts needed.
β Learn More
π Multi-Language Support¶
Charon speaks your language. The interface is available in English, Spanish, French, German, and Chinese. Switch languages instantly in settingsβno reload required.
β Learn More
π¨ Themes & Personalization¶
Make Charon look exactly the way you want. Choose from five built-in themes β Dark, Light, High Contrast Dark, High Contrast Light, and Solarized β or design your own with a full color picker. Your theme is remembered and applied the instant the page loads, with no flicker or flash.
What you can do:
- Theme Gallery β Open Settings > Appearance to browse all themes as visual preview cards. Hover over any card to see it applied live before you commit to it.
- Follow System β Turn this on and Charon automatically switches between light and dark to match your operating system's setting.
- Custom Colors β Not happy with the built-in options? Pick any color you like for every part of the interface.
- Import & Export β Save your custom theme as a file and share it with others, or load a theme someone else created. Great for backups too.
- Logo Customization β Upload your own image or paste a URL to replace the Charon logo in the sidebar with something that feels like home.
- Banner Image β Upload a custom banner image (PNG, JPG, GIF, or WebP, up to 5 MB) to display across the top of the app. Preview it before saving, and remove it any time β all from Settings > Appearance.
- Named Custom Themes β Build your own color theme from scratch, give it a name, and save it. You can create as many as you like, switch between them, edit them later, or delete ones you no longer need. Find it under Settings > Appearance.
β Learn More
π What's New¶
Never wonder what changed after an update. The next time you log in after Charon updates, a "What's New" popup shows you exactly what's new β new features, fixes, and improvements β since you were last here.
- Automatic β Content is generated straight from the release history, so there's never any manual changelog writing to fall behind on
- Nightly and development too β Development and nightly builds show the popup too, for releases up to the one they are based on
- Short and sweet β The popup shows at most the 3 newest releases you haven't seen yet
- Your call β Don't want the popup? Turn it off anytime in Settings > Appearance
- Revisit anytime β Missed it, or just want to look back? Click the "What's New" link in Settings > Appearance to browse the full history, 10 releases at a time
π¬ Feedback Widget¶
Found a bug or have an idea? The feedback button sits in the corner of every pageβclick it to report a bug or request a feature on GitHub without leaving Charon. No copy-pasting URLs, no digging through bookmarksβjust click and go.
β Open an Issue
π€ Automation & API¶
π€ REST API¶
Automate everything. Charon's comprehensive REST API lets you manage hosts, certificates, security rules, and settings programmatically. Perfect for CI/CD pipelines, Infrastructure as Code, or custom integrations.
β Learn More
π Supply Chain Security¶
π Verified Builds¶
Know exactly what you're running. Every Charon release includes:
- Cryptographic signatures β Verify the image hasn't been tampered with
- SLSA provenance attestation β Transparent build process documentation
- Software Bill of Materials (SBOM) β Complete list of included components
Enterprise-grade supply chain security for everyone.
β Learn More
π Deployment¶
π Zero-Dependency Deployment¶
One container. No external databases. No extra services. Just pull the image and run. Charon includes everything it needs, making deployment as simple as it gets.
β Learn More
π― 100% Free & Open Source¶
No premium tiers. No feature paywalls. No usage limits. Everything you see here is yours to use forever, backed by the MIT license.
β View on GitHub
What's Next?¶
Ready to get started? Check out our Quick Start Guide to have Charon running in minutes.
Have questions? Visit our Documentation or open an issue on GitHub.