selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Lobu logo

Self-host Lobu

lobu-v24.2.0

Shared context layer for AI agents using event sourcing

ReleaseOpen SourceApache-2.0
Updated13 hours ago
LanguageTypescript
Setup difficultyAdvanced
ThemeDark mode
Stars
231
Port
8787 (Web UI, API, MCP gateway)
Requires
PostgreSQL with pgvector extension
Docker
ghcr.io/lobu-ai/lobu-app
Install with Docker

What is Lobu?

Lobu is a self-hosted platform that gives AI agents a persistent, shared understanding of your organization. It captures every tool call, data change, and conversation as events tied to entities like people, projects, and customers. This creates a live knowledge graph that agents can query instead of starting fresh each session. ChatGPT, Claude, Codex, and custom agents connect via MCP to access this shared context. You can also run persistent specialist agents that handle ongoing responsibilities like customer research or support triage. Deployment options include Docker, Docker Compose, a CLI with embedded database, or Kubernetes. The project is open source under Apache-2.0.

Should you self-host Lobu?

Lobu scores 48/100 on selfhost.directory (how scoring works) and ranks #110 of 209 in AI Agents. It has 231 GitHub stars.

It shipped 10 stable releases in the past year. The latest, lobu-v24.2.0, came out on 27 October 2026. New versions land roughly every 3 days.

Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is Apache-2.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is Orca (91/100, 108 815 stars). It scores higher overall, so compare the two before you pick. See Lobu vs Orca side by side.

Features

  • Approval policies
  • Audit Trail
  • Automations
  • Connectors (60+)
  • Credential brokering
  • Cross-source context
  • Entity/knowledge graph
  • Event-sourced context layer
  • MCP Server
  • Multi-agent delegation
  • Persistent specialists
  • Sandboxed code execution
  • Shared organizational memory
  • TypeScript SDK & CLI

Lobu README

How to install Lobu

Install Lobu with Docker

PostgreSQL with pgvector extension
Environment variables
DATABASE_URL, ENCRYPTION_KEY, BETTER_AUTH_SECRET, PUBLIC_GATEWAY_URL, ANTHROPIC_API_KEY, etc.

docker volume create lobu-workspaces

docker run --rm
--name lobu
-p 8787:8787
-v lobu-workspaces:/app/workspaces
-e NODE_ENV=production
-e PUBLIC_GATEWAY_URL=https://lobu.example.com
-e DATABASE_URL='postgresql://USER:PASSWORD@HOST:5432/lobu?sslmode=require'
-e ENCRYPTION_KEY='replace-with-a-long-random-value'
-e BETTER_AUTH_SECRET='replace-with-a-long-random-value'
-e ANTHROPIC_API_KEY='sk-ant-...'
ghcr.io/lobu-ai/lobu-app:latest

Single container with embedded Postgres not included; requires external Postgres with pgvector

How to configure Lobu

  • ANTHROPIC_API_KEYAnthropic API key for Claude models

    Anthropic API key for Claude models

  • AUTH_COOKIE_DOMAINShared parent zone for per-org subdomains

    Shared parent zone for per-org subdomains

    values: .example.com

  • AUTOMATION_PAUSE_AFTER_CONSECUTIVE_FAILURES5Pause schedule after consecutive failures

    Pause schedule after consecutive failures

  • BETTER_AUTH_SECRET32-byte base64 signing admin session cookies

    32-byte base64 signing admin session cookies

    values: openssl rand -base64 32

  • CLAUDE_CODE_OAUTH_TOKENOAuth token alternative to ANTHROPIC_API_KEY for Claude Code

    OAuth token alternative to ANTHROPIC_API_KEY for Claude Code

  • DASHSCOPE_API_KEYDashScope API key

    DashScope API key

  • DATABASE_URLpostgresql://lobu:lobu@localhost:5432/lobu?sslmode=disablePostgres connection string with pgvector extension

    Postgres connection string with pgvector extension

  • ENCRYPTION_KEY32-byte base64 key encrypting secrets stored in Postgres

    32-byte base64 key encrypting secrets stored in Postgres

    values: openssl rand -base64 32

  • FRAME_ANCESTORSAllowed origins for embedding admin UI

    Allowed origins for embedding admin UI

    values: comma-separated origins

  • GEMINI_API_KEYGoogle Gemini API key

    Google Gemini API key

  • GROQ_API_KEYGroq API key

    Groq API key

  • LOBU_SYSTEM_SKILLS_URLURL pointing to system skills config

    URL pointing to system skills config

    values: file:///app/config/system-skills.json

  • LOG_LEVELINFOLogging level

    Logging level

  • MIN_CLIENT_VERSIONFirst-party client version floor map

    First-party client version floor map

    values: platform=version comma-separated

  • NODE_ENVdevelopmentEnvironment mode

    Environment mode

    values: production, development

  • OPENAI_API_KEYOpenAI API key

    OpenAI API key

  • OPENROUTER_API_KEYOpenRouter API key

    OpenRouter API key

  • PUBLIC_GATEWAY_URLhttp://localhost:8787/lobuPublic gateway base URL for OAuth callbacks, webhooks, links

    Public gateway base URL for OAuth callbacks, webhooks, links

  • SKIP_MIGRATIONSSkip database migrations on startup

    Skip database migrations on startup

    values: 1

  • SKIP_SCHEMA_VERSION_CHECKEmergency forward-flight past schema version assertion

    Emergency forward-flight past schema version assertion

    values: 1

  • TIMEOUT_MINUTES10Execution timeout in minutes

    Execution timeout in minutes

  • WORKER_ALLOWED_DOMAINSComma-separated allowlist for worker internet access

    Comma-separated allowlist for worker internet access

    values: domain list or *

  • WORKER_IDLE_CLEANUP_MINUTES60Worker idle cleanup time in minutes

    Worker idle cleanup time in minutes

Lobu releases & version history

More in Knowledge Management

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…