1. Get an API Key
Sign in to dashboard.logflux.io and go to Settings > API Keys. Create a new key – it will look like eu-lf_abc123....
2. Install the Agent
Quick install (Linux/macOS):
| |
Other methods:
| Method | Command |
|---|---|
| APT (Debian/Ubuntu) | curl -fsSL https://download.logflux.io/apt/install.sh | sudo bash |
| Homebrew (macOS) | brew install logflux-io/tap/logflux-agent |
| Docker | docker run -d -e LOGFLUX_API_KEY=eu-lf_... logflux/logflux-agent:latest |
See Agent Installation for all options including RPM and Kubernetes.
3. Configure
Set your API key in the agent config:
| |
| |
That’s the only required field. Start the agent:
| |
4. Send Your First Log
| |
With severity levels:
| |
5. Verify
| |
Your logs are now encrypted client-side (AES-256-GCM) and flowing to LogFlux. Encryption keys are negotiated automatically during the handshake – no manual key setup required. See Security & Encryption for the full protocol.
Use an SDK Instead
Send logs directly from your application code – no agent needed:
| Language | Install | Link |
|---|---|---|
| Go | go get github.com/logflux-io/logflux-go-sdk/v3 | Go SDK |
| JavaScript | npm install @logflux-io/logflux-js-sdk | JS SDK |
| Python | pip install logflux-sdk | Python SDK |
| Java | Maven/Gradle (io.logflux:logflux-sdk) | Java SDK |
| Swift | Swift Package Manager | Swift SDK |
All SDKs handle encryption and key negotiation automatically. Initialize with your API key and start logging:
| |
Next Steps
- Agent Configuration – log sources, plugins, batching, filters
- Ingestion API – multipart/mixed format, entry types
- Architecture – how data flows end to end
- Integrations – Docker, Kubernetes, OpenTelemetry, and more
- Pricing & Plans – per-event pricing from Free to Professional