alias2k/flusso repository overview

⁠flusso

Keep OpenSearch in sync with Postgres, driven by declarative config.

You describe a search document in a bit of YAML. flusso derives the index mapping, seeds it from your existing rows, then tails Postgres' logical replication stream so the index stays current — no cron job, no nightly reindex, no hand-rolled for row in rows: es.index(...) script.

You describe the what; flusso handles the keep-it-in-sync.

⁠This image

Registry-ready and config-less by design — it bakes in no config and no secrets. You supply a flusso.toml (+ schemas) or a compiled flusso.lock at run time, and connection/sink URLs come from the environment.

• Runs as a non-root user (65532)
• Exposes the operational HTTP surface on 9464 (/healthz, /readyz, /status, /metrics)
• Multi-arch: linux/amd64, linux/arm64

⁠Quick start

Mount a config and run:

docker run --rm \
  -v "$PWD/flusso.toml:/app/flusso.toml:ro" \
  -v "$PWD/schemas:/app/schemas:ro" \
  -e DATABASE_URL=postgres://user:pass@host/db \
  -e PRIMARY_OPENSEARCH_URL=https://host:9200 \
  -p 9464:9464 \
  alias2k/flusso:latest run --config /app/flusso.toml

With no --config, the entrypoint runs the baked /app/flusso.lock (useful for child images that bake their own lock).

Tags
 - latest, X.Y.Z — released builds (from flusso-cli-vX.Y.Z tags)
 - dev — manual/preview builds

Links
 - Source & full docs: https://github.com/alias2k/flusso
 - License: Apache-2.0