How do I deploy Logwell on Railway?

You can deploy Logwell on Railway by clicking the "Deploy Now" button on this page. Railway will automatically set up all the necessary services and configurations for you.

What are the system requirements?

Railway handles all the infrastructure requirements. You only need a web browser to deploy and manage your application.

Is this template free to use?

Yes, this template is free to use within your existing Railway account.

Can I customize this template?

Yes, you can fully customize this template. After deployment, you will have full control of what you've deployed in your Railway project.

How do I get support for this template?

You can get support through our community forum: logwell-4a06f9dc, or join our Discord community for more assistance.

Deploy and Host Logwell on Railway

Logwell is a lightweight, self-hosted log aggregation platform built with SvelteKit and PostgreSQL. It provides real-time streaming, full-text search, and OTLP-compatible ingestion without the complexity of ELK or the costs of SaaS solutions. Engineered for simplicity and performance, Logwell allows you to own your data completely while providing a clean UI for viewing and searching logs.

About Hosting Logwell

Hosting Logwell requires a PostgreSQL database and a Bun runtime environment. The platform leverages PostgreSQL's built-in tsvector capabilities for high-performance full-text search, eliminating the need for Elasticsearch or separate search clusters. Railway's deployment is fully automated—the template provisions a PostgreSQL instance, configures all required environment variables, and establishes health monitoring. The application runs database migrations on startup and handles session encryption automatically.

Common Use Cases

Centralized Logging: Aggregate logs for side projects, startups, and small teams without worrying about per-GB pricing or retention limits
Real-time Monitoring: Debug applications during development with live SSE (Server-Sent Events) log streaming
Data Sovereignty: A self-hosted alternative to Datadog, Logtail, or Papertrail that ensures complete ownership and privacy of your log data
OTLP Integration: seamless compatibility with OpenTelemetry SDKs, serving as a backend for apps already using OTLP exporters

Dependencies for Logwell Hosting

PostgreSQL 12+: Primary database used for storing logs, user sessions, and executing full-text search queries via tsvector
Bun 1.0+: The JavaScript runtime used to power the SvelteKit backend (included in the Docker image)

Deployment Dependencies

Logwell GitHub Repository - Source code and issue tracking
Logwell Documentation - Setup guides and API reference
OpenTelemetry Log Exporters - Standard for OTLP ingestion

Required Environment Variables

Variable	Description
`BETTER_AUTH_SECRET`	Secret key for session encryption (auto-generated by Railway)
`DATABASE_URL`	PostgreSQL connection string (auto-set by Railway)

Optional Configuration

Variable	Default	Description
`ADMIN_PASSWORD`	`null`	If set, seeds an initial admin account (`[email protected]`) on startup

Why Deploy Logwell on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Logwell on Railway, you get:

One-click provisioning of the required PostgreSQL database with zero configuration
Automatic migrations that run immediately upon deployment to set up your schema
Secure session management with auto-generated encryption secrets
Full-stack hosting that keeps your log aggregator close to your other services
Vertical scaling to handle increased log volume without migration headaches

Railway handles the infrastructure complexity so you can focus on debugging and monitoring your applications.