2 releases
new 0.1.1 | Oct 22, 2024 |
---|---|
0.1.0 | Jul 17, 2023 |
#109 in Asynchronous
94 downloads per month
180KB
3K
SLoC
Welcome to Stilgar!
Stilgar is a lightweight, no-fuss, drop-in replacement for Rudderstack.
Key features:
- Seamlessly compatible with all Rudderstack client SDKs
- Runs anywhere, with minimal hardware requirements
- No Kubernetes, Docker or Rudderstack Cloud subscription required
- No planes (this ain't the Marvel multiverse)
- Keeps It Simple, Stupid
Supported sources:
- Any Rudderstack SDK should work, be it web, mobile or whatever
At present, Clickhouse (over gRPC) is the only supported destination.
Installing
Stilgar can be installed using cargo:
$ cargo install stilgar
Remember to add ~/.cargo/bin
to your PATH
as this is the default
install location for cargo.
Building and running
Build with :
$ cargo doc --no-deps # for auto docs
$ cargo build --release # actual build
Stilgar takes a single runtime argument: the path to its configuration
file. This can also be provided in the STILGAR_CONFIG
environment
variable. When neither of those is provided, Stilgar tries those
locations in order:
- /etc/withings/stilgar.yml
- /etc/withings/stilgar.yaml
- ~/.config/stilgar/stilgar.yml
- ~/.config/stilgar/stilgar.yaml
- ./stilgar.yml
- ./stilgar.yaml
For configuration instructions, see the stilgar.sample.yml file.
Contributing
If you intend to explore/extend/review the code, start with doc/design.md for an overview.
Dependencies
~19–33MB
~600K SLoC