怎么部署langfuse

参考：
https://github.com/langfuse/langfuse
1.使用docker部署
下载代码部署

# Clone repository
git clone https://github.com/langfuse/langfuse.git
cd langfuse

# Run server and database
docker compose up -d

2. web访问

# http://ip:3000

使用邮箱注册一个账号使用

2024-09-27补充开始
怎么升级

1. 停止

# docker-compose down

2. 下载最新镜像

# docker pull langfuse/langfuse

3. 启动

# docker-compose up -d

查看版本已经是最新版本

2024-09-27补充结束
2025-07-23补充开始
如果langfuse的版本是3则升级前需要下载的镜像是langfuse/langfuse:3
即更新镜像的命令需要修改为

# docker pull langfuse/langfuse:3

2025-07-23补充结束
2025-02-11补充开始
怎么从V2版本升级至V3版本
V2版本升级至V3版本参考官方文档
https://langfuse.com/self-hosting/upgrade-guides/upgrade-v2-to-v3
如果部署未使用绝对路径挂载pg数据则pg数据不会持久化
首先需要获取pg数据

• 获取pg数据位置
  通过docker id获取数据位置

# docker inspect f02bb1c2d554

以下为pg数据在属主机目录

把该文件夹数据拷贝至持久化目录

# cp -r /var/lib/docker/volumes/langfuse_database_data/_data  /root/langfuse/database_data/

• 修改docker-compose.yml配置文件设置持久化目录
  如下图所示
  

需要修改为绝对目录,否则该目录在启动后无数据

修改后的完整配置文件如下

# cat docker-compose.yml.v2.bak 
services:
  langfuse-server:
    image: langfuse/langfuse:2.8
    restart: always
    depends_on:
      db:
        condition: service_healthy
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgresql://postgres:postgres@db:5432/postgres
      - NEXTAUTH_SECRET=mysecret
      - SALT=mysalt
      - NEXTAUTH_URL=http://langfuse.xxx.com
      - TELEMETRY_ENABLED=${TELEMETRY_ENABLED:-true}
      - LANGFUSE_ENABLE_EXPERIMENTAL_FEATURES=${LANGFUSE_ENABLE_EXPERIMENTAL_FEATURES:-false}

  db:
    image: postgres
    restart: always
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 3s
      timeout: 3s
      retries: 10
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=postgres
    ports:
      - 5432:5432
    volumes:
      - /root/langfuse/database_data:/var/lib/postgresql/data

volumes:
  database_data:
   driver: local

• 下载V3版本的docker-compose配置文件

下载地址

# https://github.com/langfuse/langfuse/blob/main/docker-compose.yml

修改配置文件，需要修改两处
一处是postgres需要使用16版本，如果使用最新版本则启动后数据保存
一处是postgres的数据目录，设置为V2版本的数据目录

重启

# docker-compose down
# docker-compose up -d

2025-02-11补充结束