lavr/express-botx repository overview
express-botx
CLI and HTTP server for sending messages to eXpress corporate messenger via BotX API.
Accepts webhooks from Alertmanager and Grafana, supports async delivery via RabbitMQ/Kafka, works as a CLI tool or HTTP service.
Features
- Send messages from CLI, scripts, CI/CD pipelines
- API requests — arbitrary eXpress BotX API calls from CLI with auto-authentication
- HTTP server with API for sending messages and receiving webhooks
- Alertmanager & Grafana — built-in webhook endpoints for monitoring
- Async queues — RabbitMQ or Kafka for reliable delivery
- Secrets — environment variables and HashiCorp Vault support
- Kubernetes-ready — Docker, Helm chart, binary
Image variants
| Tag | Base | Description |
|---|---|---|
latest, <version> | Alpine 3.21 | Default image |
latest-rootless, <version>-rootless | scratch | Minimal image, runs as non-root (UID 65534) |
Both variants are built for linux/amd64 and linux/arm64.
Quick Start
Send a message
docker run --rm -v ./config.yaml:/config.yaml \
lavr/express-botx send --config /config.yaml "Hello!"
Run HTTP server
docker run -d -p 8080:8080 -v ./config.yaml:/config.yaml \
lavr/express-botx serve --config /config.yaml
HTTP Endpoints
| Method | Path | Description |
|---|---|---|
GET | /healthz | Health check |
POST | /api/v1/send | Send message |
POST | /api/v1/alertmanager | Alertmanager webhook |
POST | /api/v1/grafana | Grafana webhook |
All POST endpoints require Authorization: Bearer <key>.
Documentation
Full documentation: github.com/lavr/express-botx
License
MIT
Tag summary
Content type
Image
Digest
sha256:515d84ff5…
Size
10.9 MB
Last updated
about 16 hours ago
docker pull lavr/express-botx