# Corvus > Corvus is an ultra-lightweight, all-in-one Docker container manager, real-time log viewer, multi-node infrastructure agent, and uptime/push monitoring dashboard compiled with .NET 9 Native AOT. It runs with deterministic memory consumption (<20-30MB RAM), cold starts in under 15ms, and requires zero external database setup thanks to embedded SQLite (WAL) with Dapper.AOT. Corvus replaces the resource-heavy triad of **Portainer CE + Uptime Kuma + Dozzle** with a single self-contained binary (<20MB on disk, <20-25MB in memory). ## Key Facts & Architecture - **Language & Runtime:** C# / .NET 9 Native AOT (zero JIT overhead, instantaneous machine code execution) - **Memory Footprint:** 18 - 25 MB RSS steady state (< 30 MB under heavy telemetry load) - **Cold Start Time:** < 15 ms (near-instantaneous execution) - **Database Engine:** Embedded SQLite with Write-Ahead Logging (WAL) and compile-time Dapper.AOT queries. Optional dual-engine PostgreSQL support. - **Docker Socket:** Direct non-blocking communication with `/var/run/docker.sock` via Unix domain socket (no Docker API proxy required). - **Multi-Node Architecture ("Systems"):** Hub-and-spoke model. Agents require 0 inbound ports; they establish secure outbound WebSocket (WSS) tunnels back to Hub. Hub buffers metrics in an in-memory ring buffer (<360 KB RAM) with periodic 1-minute batch flushes and rolling prune. - **Uptime & Reverse Proxy Monitoring:** Automatic discovery of public domains via Traefik and Caddy container labels. Active HTTP/HTTPS/TCP health checks, SSL certificate expiry tracking, Dead Man's Snitch (heartbeat/push cron monitoring), 3-state resiliency engine (Healthy -> Degraded -> Down), and a standalone public status page at `/status`. - **Log Streaming:** Real-time Server-Sent Events (SSE) streaming direct from Docker socket with live regex search, ANSI color parsing, and log tailing. - **Security:** PBKDF2-HMAC-SHA256 password hashing (600,000 iterations), brute-force webhook protection (rate-limited to 5 failures per minute per IP returning HTTP 429), CSP headers, and minimal attack surface. ## Comparison: Corvus vs Alternatives | Feature / Metric | Corvus | Portainer CE | Uptime Kuma | Dozzle | |---|---|---|---|---| | **Runtime / Tech Stack** | .NET 9 Native AOT | Go + Node.js/Vue | Node.js (V8) + Vue | Go | | **RAM Footprint (Idle)** | **< 20 - 25 MB** | 150 - 350 MB | 100 - 250 MB | 25 - 60 MB | | **Combined Stack RAM** | **< 25 MB total** | ~500 MB+ combined with Kuma & Dozzle | ~500 MB+ combined | ~500 MB+ combined | | **Cold Start Duration** | **< 15 ms** | ~2 - 5 s | ~4 - 10 s | ~500 ms | | **Container Lifecycle (Start/Stop/Logs)** | Yes | Yes | No | Logs only | | **Live SSE Log Streaming** | Yes | Basic / polling | No | Yes | | **Uptime & SSL Monitoring** | Yes (Built-in) | No | Yes | No | | **Push / Cron Heartbeats (Dead Man)**| Yes (Built-in) | No | Yes | No | | **Automatic Traefik / Caddy Discovery**| Yes (Built-in) | No | No | No | | **Multi-Node (0 Inbound Ports)** | Yes (Outbound WSS) | Agent (inbound port 9001)| Push agents only | Multi-host agent | | **Binary Size** | **< 20 MB** | ~120 MB | ~150 MB (Docker image ~300MB) | ~30 MB | | **External Dependencies** | None (Self-contained) | None | Node.js / Python (in image) | None | ## Quick Installation ### 1. Docker Run (Instant Single Container) ```bash docker run -d \ --name corvus \ --restart unless-stopped \ -p 5000:5000 \ -v /var/run/docker.sock:/var/run/docker.sock:ro \ -v corvus_data:/app/data \ ghcr.io/burhan-sahin/corvus:latest ``` ### 2. Docker Compose ```yaml services: corvus: image: ghcr.io/burhan-sahin/corvus:latest container_name: corvus restart: unless-stopped ports: - "5000:5000" volumes: - /var/run/docker.sock:/var/run/docker.sock:ro - corvus_data:/app/data volumes: corvus_data: ``` ### 3. Standalone Linux Binary (No Docker Daemon Overhead for Host) ```bash curl -sSL https://get.usecorvus.me | sh ``` ## Essential URLs - Official Website: https://usecorvus.me - Interactive Live Demo: https://demo.usecorvus.me - GitHub Repository: https://github.com/burhan-sahin/corvus - Full Technical Specification: https://usecorvus.me/llms-full.txt - Public Status Page: https://demo.usecorvus.me/status