Falcosidekick connects Falco to your ecosystem. Falco posts its events over HTTP, and Falcosidekick forwards each one to the chat, alerting, logging, streaming and storage systems you configure, with retries, metrics and a web UI.
Note
This branch is Falcosidekick v3, in beta. v2 is on the 2.x branch and its images keep the latest and 2.* tags. v2 configuration is not compatible with v3: see Migrate from v2.
flowchart LR
F1[Falco] -->|HTTP :2801| S
F2[Falco] -->|HTTP :2801| S
S[Falcosidekick] --> O1[Slack, Teams, Discord]
S --> O2[Alertmanager, PagerDuty, Opsgenie]
S --> O3[Loki, Elasticsearch, Syslog]
S --> O4[Kafka, SQS, SNS, Pub/Sub]
S --> O5[S3, Redis, OTLP, Webhook, ...]
One Falcosidekick serves any number of Falco instances. Each output has its own queue, so a slow or failing destination does not delay the others.
- Reliable delivery. Per output: a queue, retries with backoff, a circuit breaker and optional batching. Permanent rejections are not retried, and after a partial batch failure only the events that can still be delivered are retried.
- Configuration as files. A core file (
-c) and one or more output files (-o), with snake_case keys. Output files reload on change, onSIGHUPor by polling, without a restart. - Secrets from files. Every secret field has a
<field>_filevariant, read from a mounted Secret. - Web UI and API. Dashboard, pipeline, configuration and events pages, on a separate management listener (
127.0.0.1:2802by default). Read-only unlessapi.allow_writesis set. - Persistence. Outputs created through the API are kept in memory, sqlite or postgres, never with secret values. Postgres replicas stay in step.
- Observability. Prometheus metrics for every delivery outcome,
/livezand/readyzprobes, JSON logs. - Secure defaults. Distroless image running as uid/gid 65532, signed with cosign; releases carry SLSA provenance.
The dashboard shows what needs attention now: outputs that do not deliver and critical events. The pipeline page shows each output with its queue, circuit breaker and last error; the events page searches and filters the events the UI stores.
|
|
The UI is off by default. Install shows how to turn it on.
The v3 chart is a pre-release, so Helm installs it only with --devel:
helm repo add falcosecurity https://falcosecurity.github.io/charts
helm repo update
helm install falcosidekick falcosecurity/falcosidekick --devel \
--namespace falco --create-namespace \
--set outputs.webhook.host=http://receiver.example:8080# outputs.yaml
outputs:
webhook:
host: "http://receiver.example:8080"
endpoint: /falcodocker run -d --name falcosidekick -p 2801:2801 \
-v "$PWD/outputs.yaml:/etc/falcosidekick/outputs.yaml:ro" \
falcosecurity/falcosidekick:3.0.0-beta.1 \
-o /etc/falcosidekick/outputs.yaml
curl -s localhost:2801/readyzIn falco.yaml:
json_output: true
json_include_output_property: true
http_output:
enabled: true
url: "http://falcosidekick:2801/"Install covers the core file, Kubernetes manifests, the web UI, persistence and image verification.
| Category | Outputs |
|---|---|
| Chat | Slack, Microsoft Teams, Discord |
| Alerting and on-call | Alertmanager, PagerDuty, Opsgenie, Grafana OnCall, Datadog |
| Logs | Loki, Elasticsearch, Syslog |
| Queues and streams | Apache Kafka, Amazon SQS, Amazon SNS, Google Pub/Sub |
| Storage | Amazon S3, Redis, In-memory store |
| Observability | OpenTelemetry (OTLP) |
| SMTP | |
| Webhooks | Webhook, CloudEvents |
| Response | Falco Talon |
| Other | Policy Report |
Each page has the settings, an example and the tested versions. Settings shared by several outputs are in common settings.
| Port | Default address | Serves |
|---|---|---|
| 2801 | all interfaces, IPv4 and IPv6 | Falco events (POST /), /livez, /readyz, /metrics |
| 2802 | 127.0.0.1 |
API and web UI. The API has no authentication: expose it only to trusted clients. |
| Version | Branch | Status | Image tags |
|---|---|---|---|
| v3 | master |
Beta | 3.* releases, v3-main builds of master; -slim variants without the UI |
| v2 | 2.x |
Maintenance, security and critical fixes only | latest, 2.* |
Images are published to Docker Hub. Install lists every tag and how to verify the signatures.
- Install: container, Helm, Kubernetes, web UI, persistence
- Configuration: every key of the core file
- Outputs: one page per output
- Helm chart: every chart value
- Migrate from v2
- Known limits of the beta
Requires Go and Bun.
make falcosidekick # binary with the web UI
make falcosidekick-slim # binary without the web UI
make image # local image falcosidekick:local
make verify # the checks CI runsIssues and pull requests are welcome; see the Falco contributing guidelines. v2 fixes go to the 2.x branch. Talk to the community in the #falco channel of the Kubernetes Slack.

