<img src="static/banner.png" alt="Logwell - Self-hosted logging for high-performance apps" width="100%"> Logwell is a self-hosted logging platform with real-time streaming, full-text search, and OTLP-compatible ingestion. Deploy in minutes, own your data. Alpha Software — Expect breaking changes. Not recommended for production workloads. <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a> <a href="https://github.com/divkix/logwell/stargazers"><img src="https://img.shields.io/github/stars/divkix/logwell" alt="GitHub stars"></a> <a href="https://github.com/divkix/logwell/actions"><img src="https://img.shields.io/github/actions/workflow/status/divkix/logwell/ci.yml?branch=main" alt="Build Status"></a> <a href="https://www.npmjs.com/package/logwell"><img src="https://img.shields.io/npm/v/logwell" alt="npm version"></a> <a href="https://jsr.io/@divkix/logwell"><img src="https://jsr.io/badges/@divkix/logwell" alt="JSR"></a> <a href="https://pypi.org/project/logwell/"><img src="https://img.shields.io/pypi/v/logwell" alt="PyPI version"></a> <a href="https://pkg.go.dev/github.com/Divkix/Logwell/sdks/go/logwell"><img src="https://pkg.go.dev/badge/github.com/Divkix/Logwell/sdks/go/logwell.svg" alt="Go Reference"></a> <img src="https://img.shields.io/badge/TypeScript-5.9-blue?logo=typescript&logoColor=white" alt="TypeScript"> <img src="https://img.shields.io/badge/Python-3.9+-3776AB?logo=python&logoColor=white" alt="Python"> <img src="https://img.shields.io/badge/Go-1.21+-00ADD8?logo=go&logoColor=white" alt="Go"> <img src="https://img.shields.io/badge/Bun-1.0+-black?logo=bun&logoColor=white" alt="Bun"> <a href="#features">Features</a> • <a href="#quick-start">Quick Start</a> • <a href="#usage">Usage</a> • <a href="#production-deployment">Deploy</a> • <a href="#contributing">Contributing</a> • <a href="#license">License</a>

What is Logwell?

Logwell is a lightweight, self-hosted log aggregation platform for developers who want structured logging without the complexity of ELK or the costs of cloud services.

Use Logwell when you need:

A simple logging backend for your side project or startup
Full-text search across logs without managing Elasticsearch
Real-time log streaming during development and debugging
Complete data ownership with no vendor lock-in

Logwell is NOT for:

High-volume production systems (10k+ logs/second) — use Loki or Clickhouse
Teams needing RBAC, audit trails, or compliance features — use a managed service
Distributed tracing or metrics — Logwell is logs-only

Features

OTLP-native ingestion — Standard OpenTelemetry protocol, no proprietary SDKs required
PostgreSQL backend — Full-text search via tsvector, no separate search cluster needed
Real-time streaming — SSE-powered live log tailing with batching
Incident intelligence — Error/fatal fingerprinting with incident timeline and correlation hints
Project isolation — Per-project API keys with separate log streams
Zero telemetry — No phone-home, no tracking, fully air-gapped deployments supported
Clean UI — Minimal interface with dark mode and log level color coding

Preview

<video src="static/demo.mp4" width="100%" autoplay loop muted playsinline></video> Real-time log streaming demo <table> <tr> <td width="50%"> <img src="static/logview-screen.png" alt="Log Viewer"> Real-time log viewer with level filtering </td> <td width="50%"> <img src="static/logs-view-empty.png" alt="Quick Start"> Quick Start with pre-filled API key </td> </tr> <tr> <td width="50%"> <img src="static/project-settings.png" alt="Project Settings"> API key management and code snippets </td> <td width="50%"> <img src="static/stats-screen.png" alt="Statistics"> Log level distribution analytics </td> </tr> </table>

Why Logwell?

| vs | Logwell advantage | |----|-------------------| | Loki/Grafana | Built-in UI, no LogQL to learn, just PostgreSQL | | ELK | Lightweight PostgreSQL backend, not Elasticsearch | | Datadog/etc | Self-hosted, no per-GB pricing, own your data |

Tech Stack

| Layer | Technology | |-------|------------| | Framework | SvelteKit | | Database | PostgreSQL | | ORM | Drizzle | | Auth | better-auth | | UI | shadcn-svelte + Tailwind CSS v4 | | Real-time | Server-Sent Events | | Runtime | Bun |

Prerequisites

Bun >= 1.0
Docker (for PostgreSQL)

Quick Start

# Clone the repository
git clone https://github.com/divkix/logwell.git
cd logwell

# Install dependencies
bun install

# Set up environment
cp .env.example .env
# Edit .env with your values (see Environment Variables below)

# Start PostgreSQL
docker compose up -d

# Run database migrations
bun run db:migrate

# Create admin user
bun run db:seed

# Start development server
bun run dev

Open http://localhost:5173 and sign in with:

Username: admin (or your ADMIN_USERNAME from .env)
Password: Your ADMIN_PASSWORD from .env

Note: Development runs on port 5173 (Vite). Production builds run on port 3000.

Environment Variables

Create a .env file with the following:

# Database connection
DATABASE_URL="postgres://root:mysecretpassword@localhost:5432/local"

# Authentication secret (minimum 32 characters)
BETTER_AUTH_SECRET="your-32-character-secret-key-here"

# Admin user password (minimum 8 characters)
ADMIN_PASSWORD="your-admin-password"

# Admin username (optional, defaults to "admin")
# ADMIN_USERNAME="admin"

# Production URL (required for auth behind reverse proxies)
ORIGIN="https://your-domain.com"

# Log retention (optional, defaults shown)
# LOG_RETENTION_DAYS="30"        # 0 = never auto-delete
# LOG_CLEANUP_INTERVAL_MS="3600000"  # Cleanup job interval (1 hour)
# INCIDENT_AUTO_RESOLVE_MINUTES="30" # Incident resolves after N quiet minutes

Generate a secure secret:

openssl rand -base64 32

Usage

Create a Project

Sign in to the dashboard
Click New Project
Enter a project name
Copy the generated API key (lw_...)

Send Logs

Logwell provides two ingestion APIs:

| API | Endpoint | Best For | |-----|----------|----------| | Simple API | POST /v1/ingest | Quick integration, any HTTP client | | OTLP API | POST /v1/logs | OpenTelemetry SDKs, rich metadata |

Simple API (Recommended for quick start)

The simple API accepts flat JSON with minimal boilerplate:

curl -X POST http://localhost:5173/v1/ingest \
  -H "Authorization: Bearer lw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"level": "info", "message": "User signed in"}'

Batch multiple logs:

curl -X POST http://localhost:5173/v1/ingest \
  -H "Authorization: Bearer lw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '[
    {"level": "info", "message": "Request started"},
    {"level": "error", "message": "Database timeout", "metadata": {"query": "SELECT..."}}
  ]'

Available fields:

| Field | Required | Type | Description | |-------|----------|------|-------------| | level | Yes | debug | info | warn | error | fatal | Log severity | | message | Yes | string | Log message | | timestamp | No | ISO8601 string | Defaults to current time | | service | No | string | Service name for filtering | | metadata | No | object | Additional structured data |

<details> <summary>Node.js (no SDK needed)</summary>

await fetch('http://localhost:5173/v1/ingest', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer lw_YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ level: 'info', message: 'Hello from Node.js' })
});

</details> <details> <summary>Python (no SDK needed)</summary>

import requests

requests.post('http://localhost:5173/v1/ingest',
    headers={'Authorization': 'Bearer lw_YOUR_API_KEY'},
    json={'level': 'info', 'message': 'Hello from Python'})

</details> <details> <summary>Go (no SDK needed)</summary>

body := []byte(`{"level": "info", "message": "Hello from Go"}`)
req, _ := http.NewRequest("POST", "http://localhost:5173/v1/ingest", bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer lw_YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
http.DefaultClient.Do(req)

</details>

TypeScript/JavaScript SDK

For Node.js, browsers, and edge runtimes (Cloudflare Workers, etc.):

npm install logwell

import { Logwell } from 'logwell';

const logger = new Logwell({
  apiKey: 'lw_YOUR_API_KEY',
  endpoint: 'http://localhost:5173',
});

// Log at different levels
logger.info('User signed in', { userId: '123' });
logger.error('Database failed', { host: 'db.local' });

// Flush before shutdown
await logger.shutdown();

Features: Zero dependencies, automatic batching, retry with backoff, TypeScript-first, opt-in source location capture.

Deno users: Install from JSR with deno add jsr:@divkix/logwell and import from @divkix/logwell

Full SDK documentation →

Python SDK

For Python applications with automatic batching and retries:

pip install logwell

import asyncio
from logwell import Logwell

client = Logwell({
    'api_key': 'lw_YOUR_API_KEY',
    'endpoint': 'http://localhost:5173',
    'service': 'my-app',
})

# Log at different levels
client.info('User signed in', {'us

Logwell

Install / Use

README