Files
DataStack/docs/users
Team Dark Devil 89e4d68690 feat(auth): harden session management and security
- Implement server-side session revocation on logout
- Add IP extraction utility and admin setup error handling
- Improve error codes and response consistency for auth endpoints
- Refine landing page redirect logic to handle transient DB outages
- Update deployment documentation and configuration defaults
2026-11-19 20:22:01 +06:00
..

DataStack User & Operator Guide

Welcome to the DataStack User Documentation. This guide is designed for operators, administrators, product teams, and engineers who wish to deploy, operate, and collect real-time telemetry using DataStack.


What is DataStack?

DataStack is a self-hosted, lightweight telemetry and data collection platform. It enables your applications to stream events in real time, securely buffers them with Redis and in-memory batching, and persists them into clean, partitioned daily CSV files without overloading a relational database.


Documentation Navigation

Explore the following sections to get up and running:

1. Installation & Deployment

Step-by-step instructions for deploying DataStack in production:

  • Running with Docker Compose
  • 1-Click deployment on Coolify
  • Configuring environment variables & persistent volumes
  • Reverse proxy and SSL configuration

2. Feature Walkthrough

Comprehensive overview of all platform capabilities:

  • Admin Console (/vcon/): Dashboard overview, live activity preview, and storage monitors.
  • Client SDK Management: Registering client applications, issuing JWT tokens, and instant revocation.
  • Data Simulator: Interactive in-browser telemetry generation for testing without writing code.
  • Partitioned Storage: Size-based file rotation and automatic daily retention pruning.
  • Streaming Export: High-performance streaming of filtered CSV or JSON datasets.

3. Usage Tutorials

Hands-on walkthroughs for common tasks:

  • Sending your first telemetry event via HTTP REST
  • Streaming real-time events using the official Python SDK
  • Streaming local .csv, .json, and .jsonl data files
  • Exporting datasets for analysis in Excel, pandas, or DuckDB

4. Frequently Asked Questions & Troubleshooting

Answers to common operational questions:

  • How does DataStack prevent data loss during container restarts?
  • How to rotate client credentials safely without downtime
  • What to do if WebSocket handshakes fail or time out
  • How to adjust event rate limits and payload size thresholds