Deploy and Host AgentLogs on Railway

AgentLogs is an open-source observability platform that captures and analyzes transcripts from AI coding agents (Claude Code, Codex, OpenCode, Pi) to give teams visibility into AI-assisted development. It tracks sessions, links conversations to Git commits, and enables shared learning across engineering teams.

About Hosting AgentLogs

Hosting AgentLogs involves deploying a web server that collects, analyzes, and stores AI agent transcripts while providing a dashboard for team visibility. The application requires a GitHub OAuth App for authentication via BetterAuth, environment variables for OAuth credentials, and persistent volume storage for SQLite data and session blobs. AgentLogs auto-syncs transcripts from various AI agents and provides team observability metrics, Git integration linking sessions to specific commits, and a session browser for discovering effective prompts.

Common Use Cases

Team observability for AI coding workflows with activity metrics, agent usage stats, and per-member breakdowns
Git integration linking AI sessions to specific code commits for complete audit trails of AI-assisted development
Knowledge sharing by browsing and sharing team sessions to discover effective prompts and reusable workflows

Dependencies for AgentLogs Hosting

GitHub OAuth App (for authentication — create at github.com/settings/applications/new)
Persistent volume storage (for SQLite database and blob storage)

Deployment Dependencies

Implementation Details

Set the following required environment variables:

GITHUB_CLIENT_ID — Your GitHub OAuth App Client ID
GITHUB_CLIENT_SECRET — Your GitHub OAuth App Client Secret
BETTER_AUTH_SECRET — Generate with openssl rand -base64 32
WEB_URL — Your Railway public domain (e.g., https://your-project.up.railway.app)

Persistent storage is required for the /app/.data directory to maintain the SQLite database and session blobs across deployments.

Why Deploy AgentLogs 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 AgentLogs on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.