1 unstable release
0.1.0 | Jul 17, 2023 |
---|
#817 in Asynchronous
55 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
~18–35MB
~592K SLoC