Logwell for Cloudron

Logwell is a self-hosted logging platform with real-time streaming, full-text search, and OTLP-compatible ingestion. This package deploys Logwell on your Cloudron PaaS.

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

Installation

Install from the Cloudron App Store. After installation:

1. Sign in with the admin credentials shown on the post-install page
2. Create a new project
3. Copy the generated API key (lw_...)
4. Send logs via the Simple API or OTLP endpoint

Quick Start — Sending Logs

Simple API

curl -X POST https://<your-app>.domain.com/v1/ingest \
  -H "Authorization: Bearer lw_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"level": "info", "message": "Hello from my app"}'

Using SDKs

Logwell provides official SDKs for TypeScript, Python, and Go:

npm install logwell

import { Logwell } from "logwell";
const logger = new Logwell({ apiKey: "lw_YOUR_API_KEY", endpoint: "https://<your-app>.domain.com" });
logger.info("User signed in", { userId: "123" });

Health Check

The application exposes a health check at /api/health:

{
  "status": "healthy",
  "database": "connected"
}

Environment Variables

The following Cloudron addon variables are automatically configured:

Cloudron Variable	Maps To	Source
CLOUDRON_POSTGRESQL_URL	DATABASE_URL	PostgreSQL addon
CLOUDRON_APP_ORIGIN	ORIGIN	Platform

The following are auto-generated on first install:

App Variable	How It's Set
BETTER_AUTH_SECRET	Generated randomly, persisted in /app/data/state/
ADMIN_PASSWORD	Generated randomly, displayed in post-install message
ADMIN_USERNAME	Defaults to admin

Upstream

• Source: github.com/divkix/logwell
• License: MIT (see LICENSE)