Skip to main content

Self-host Langfuse v2

Note

This guide covers Langfuse v2. For the current version, see the self-hosting documentation. Langfuse v2 received security updates until end of Q1 2025. If you have any questions while upgrading, please refer to the v3 upgrade guide or open a thread on GitHub Discussions.

Langfuse is open source and can be self-hosted using Docker. This section contains guides for different deployment scenarios.

Deployment Options

The following options are available:

  • Langfuse Cloud: A fully managed version of Langfuse that is hosted and maintained by the Langfuse team.
  • Self-host Langfuse: Run Langfuse on your own infrastructure.
    • Production via Docker. Please follow the deployment guide for more details and detailed instructions on how to deploy Langfuse on various cloud providers.
    • Locally or on a single VM via Docker Compose.

Architecture

Langfuse only depends on open source components and can be deployed locally, on cloud infrastructure, or on-premises.

flowchart TB
    User["UI, API, SDKs"]
    subgraph vpc["VPC"]
        Web["Web Server (langfuse/langfuse)"]
        Postgres@{ img: "/images/logos/postgres_icon.svg", label: "Postgres Database", pos: "b", w: 60, h: 60, constraint: "on" }
    end
    LLM["LLM API/Gateway<br/>(optional; BYO; can be same VPC or VPC-peered)"]

    User --> Web
    Web --> Postgres
    Web -.->|"optional for playground"| LLM

Upgrade to Langfuse v2

If you are upgrading from Langfuse v1, please refer to the upgrade guide.

Edit on GitHub