How ingres-si/ingressi works
Ingressi is a self-hosted Caddy reverse-proxy control plane. Administrators sign in to the dashboard or use the REST API to configure proxy and L4 hosts, certificates, and optional protections; Caddy serves the resulting traffic, while analytics and audit capabilities provide operational visibility. The tree and README support the major capability branches, but sampled source does not establish most runtime call paths, so documented relationships are cited to the README rather than inferred from imports.
Main entry points: (dashboard) Web dashboard · v1 REST API · proxy-hosts Proxy hosts · l4-proxy-hosts L4 proxy hosts
Components 24
Control plane
- Web dashboard
app/(dashboard) - REST API
app/api/v1 - Application database
src/lib/db.ts
Proxy and security
- Proxy hosts
app/(dashboard)/proxy-hosts - L4 proxy hosts
app/(dashboard)/l4-proxy-hosts - Certificates
app/(dashboard)/certificates - Host protections
app/(dashboard)/waf - Access lists
app/(dashboard)/access-lists - Geo blocking and limits
app/(dashboard)/geo-blocking - Caddy proxy
Operations
- Traffic analytics
app/(dashboard)/analytics - Audit log
app/(dashboard)/audit-log - Alerting
ee/alerting - Instance sync
app/api/instances/sync/route.ts
Identity and governance
- Users and sign-in
app/(auth) - Forward-auth portal
app/api/forward-auth
Extended capabilities
- Change approvals
ee/approvals - Access reviews
ee/access-reviews - Compliance reports
ee/compliance - Fleet management
ee/fleet - High availability
ee/high-availability - AI analyst
ee/ai - API monetization
ee/monetization
Other components
- Administrator
Connections 28
- Administrator → Web dashboard: configures
- Administrator → REST API: configures
- Web dashboard → Proxy hosts: manages
- Web dashboard → L4 proxy hosts: manages
- Web dashboard → Certificates: manages
- Web dashboard → Host protections: configures
- Web dashboard → Access lists: configures
- Web dashboard → Geo blocking and limits: configures
- Proxy hosts → Caddy proxy: configures
- L4 proxy hosts → Caddy proxy: configures
- Certificates → Caddy proxy: enables HTTPS
- Host protections → Caddy proxy: protects hosts
- Access lists → Caddy proxy: controls access
- Geo blocking and limits → Caddy proxy: limits traffic
- REST API → Application database: persists configuration
- Web dashboard → Traffic analytics: views
- Web dashboard → Audit log: reviews
- Web dashboard → Alerting: manages
- Users and sign-in → Web dashboard: authenticates
- Forward-auth portal → Caddy proxy: authenticates requests
- Web dashboard → Instance sync: manages replicas
- Web dashboard → Change approvals: reviews changes
- Web dashboard → Access reviews: conducts reviews
- Web dashboard → Compliance reports: views reports
- Web dashboard → Fleet management: manages fleet
- Web dashboard → High availability: configures availability
- Web dashboard → AI analyst: uses analyst
- REST API → API monetization: offers monetization
app/api/v1/openapi.json/route.ts