Logstack

Production-Ready Log Management Platform

Real-time streaming • Smart alerts • Beautiful dashboard • Self-hostable

Documentation • Quick Start • Self-Hosting • Discord

---

Why Logstack?

Logstack is a complete log management solution designed for modern applications. Unlike complex enterprise tools, Logstack is simple to set up, easy to self-host, and built with developers in mind.

Feature	Logstack	Datadog	Logtail	Self-built
Real-time streaming	✅	✅	✅	❌
Smart alerting	✅	✅	✅	❌
Mobile app	✅	❌	❌	❌
Self-hostable	✅	❌	❌	✅
Open source	✅	❌	❌	✅
Free tier	✅	Limited	Limited	✅
Setup time	5 min	30 min	15 min	Days

Features

• 📡 Real-time Streaming — WebSocket-powered live log streaming to dashboard and mobile
• 🔔 Smart Alerts — Pattern matching with cooldowns, email & push notifications
• 📊 Beautiful Dashboard — Search, filter, and analyze logs with an intuitive interface
• 📱 Mobile Apps — iOS & Android apps with offline support
• 🔌 Easy Integration — Official SDKs for JavaScript/TypeScript, Go, and Python
• 🏠 Self-Hostable — Deploy on your infrastructure with Docker Compose
• 🔒 Secure — JWT authentication, rate limiting, CORS protection

Quick Start

1. Install an SDK

# JavaScript / TypeScript
npm install logstack-js

# Go
go get github.com/mosesedem/logstack/packages/logstack-go-sdk@v1.0.3

# Python
pip install logstack-py

2. Start logging

import { createLogStack } from "logstack-js";

const logstack = createLogStack({
  apiKey: process.env.LOGSTACK_API_KEY,
});

logstack.info("User signed up", { userId: "user_123", plan: "pro" });
logstack.error("Payment failed", { orderId: "order_456" });

process.on("SIGTERM", () => logstack.close());

Go and Python examples: docs/SDK.md · Go · Python.

3. View your logs

Open the Logstack dashboard to see logs streaming in real time.

Self-Hosting

Deploy Logstack on your own infrastructure in minutes:

# Clone the repository
git clone https://github.com/mosesedem/logstack.git
cd logstack

# Configure environment
cp .env.example .env
# Edit .env with your settings

# Start all services
docker-compose up -d

# Verify deployment
curl http://localhost:8080/health

See the Self-Hosting Guide for detailed instructions.

Architecture

┌─────────────────────────────────────────────────────────────────┐
│                         Client Layer                             │
├──────────────────────┬──────────────────────┬───────────────────┤
│  SDKs (JS/Go/Python) │  Next.js Dashboard   │  Flutter App      │
│  logstack-js / -py   │  (Web Interface)     │  (iOS/Android)    │
└──────────┬───────────┴──────────┬───────────┴───────┬───────────┘
           │                      │                   │
           └──────────────────────┼───────────────────┘
                                  │
                         ┌────────▼─────────┐
                         │   Load Balancer  │
                         └────────┬─────────┘
                                  │
    ┌──────────────────────────────┼──────────────────────────────┐
    │                              │                              │
┌───▼────┐                 ┌───────▼────────┐            ┌───────▼────────┐
│ Go API │                 │   WebSocket    │            │  Worker Pool   │
│ Server │                 │   Server       │            │  (Alerts)      │
└───┬────┘                 └───────┬────────┘            └───────┬────────┘
    │                              │                              │
    └──────────────────────────────┼──────────────────────────────┘
                                   │
              ┌────────────────────┼────────────────────┐
              │                    │                    │
       ┌──────▼──────┐      ┌──────▼──────┐     ┌───────▼───────┐
       │ PostgreSQL  │      │    Redis    │     │ Resend / FCM  │
       └─────────────┘      └─────────────┘     └───────────────┘

Project Structure

logstack/
├── packages/
│   ├── logstack-js/        # JavaScript/TypeScript SDK (npm: logstack-js)
│   ├── logstack-go-sdk/    # Go SDK
│   ├── logstack-python/    # Python SDK (PyPI: logstack-py)
│   ├── logstack-go/        # Go backend API server
│   └── shared-types/       # Shared TypeScript types
├── apps/
│   ├── web/                # Next.js dashboard + fumadocs
│   └── mobile/             # Flutter mobile app
├── docs/                   # Reference Markdown (incl. multi-SDK SDK.md)
└── infra/                  # Infrastructure configs

Documentation

• Quick Start — Get up and running in 5 minutes
• SDK Overview — JavaScript, Go, and Python
• Go SDK · Python SDK · JS SDK
• API Reference — REST API endpoints and authentication
• Self-Hosting — Deploy Logstack on your infrastructure
• Production Checklist — Security and performance best practices
• docs/SDK.md — Offline multi-language SDK reference

Development

Prerequisites

• Node.js 18+
• Go 1.21+
• Docker & Docker Compose
• Flutter 3.10+ (for mobile)
• pnpm 8+

Setup

# Clone and install dependencies
git clone https://github.com/mosesedem/logstack.git
cd logstack
pnpm install

# Start infrastructure
docker-compose -f docker-compose.dev.yml up -d

# Start Go backend
cd packages/logstack-go
go run cmd/server/main.go

# Start web dashboard (new terminal)
cd apps/web
pnpm dev

# Start mobile app (new terminal)
cd apps/mobile
flutter run

Contributing

We welcome contributions! Please see our Contributing Guide for details.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Community

• Discord — Chat with the community
• GitHub Discussions — Ask questions and share ideas
• Twitter — Follow for updates

License

Logstack is open source software licensed under the MIT License.

---

Made with ❤️ by the Logstack team