How do I install the Langfuse Backup skill?

Run npx skillmds@latest add dvcrn/langfuse-backup in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Langfuse Backup safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Langfuse Backup?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Langfuse Backup free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Langfuse Backup?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Langfuse Backup by dvcrn — Agent Skill

Name: Langfuse Backup
Rating: 4.2 (5 reviews)
Author: dvcrn

Langfuse Backup

Docker volume backup and restore for self-hosted Langfuse. Use when: backing up a self-hosted Langfuse instance, restoring Langfuse after a crash or migration, setting up daily cron backups for Langfuse postgres/clickhouse/minio/redis volumes. Backs up postgres (traces, scores), minio (blobs), with optional clickhouse and redis. Includes restore script with validation and 14-day retention pruning.

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

langfuse-backup

Backup and restore Docker volumes for a self-hosted Langfuse instance.

Scripts

scripts/backup_langfuse.sh — back up postgres + minio volumes (primary data)
scripts/restore_langfuse.sh — restore from a specific backup date

Quick start

# Configure (env vars or edit the script defaults)
export LANGFUSE_BACKUP_DIR="$HOME/.langfuse-backups"
export LANGFUSE_COMPOSE_DIR="/path/to/langfuse"   # directory with docker-compose.yml
export LANGFUSE_DB_CONTAINER="langfuse-db-1"       # postgres container name
export LANGFUSE_MINIO_CONTAINER="langfuse-minio-1" # minio container name
export LANGFUSE_DB_NAME="langfuse"                  # postgres database name
export LANGFUSE_DB_USER="langfuse"                  # postgres user

# Run a backup
bash scripts/backup_langfuse.sh

# List available backups
ls "$LANGFUSE_BACKUP_DIR"

# Restore from a date
bash scripts/restore_langfuse.sh 2026-02-27

Env vars

Var	Default	Description
`LANGFUSE_BACKUP_DIR`	`~/.langfuse-backups`	Root backup directory
`LANGFUSE_COMPOSE_DIR`	`~/langfuse`	Docker Compose project directory
`LANGFUSE_DB_CONTAINER`	`langfuse-db-1`	Postgres container name
`LANGFUSE_MINIO_CONTAINER`	`langfuse-minio-1`	MinIO container name
`LANGFUSE_DB_NAME`	`langfuse`	Postgres database name
`LANGFUSE_DB_USER`	`langfuse`	Postgres user
`LANGFUSE_RETENTION_DAYS`	`14`	How many days of backups to keep

What gets backed up

Volume	Backed up?	Notes
Postgres	✅ Yes	`pg_dump` → `.sql.gz` — traces, scores, evals
MinIO	✅ Yes	`tar.gz` — uploaded blobs
ClickHouse	⚠️ Optional	Large; many users skip (replayed from traces)
Redis	⚠️ Skip	Cache only — safe to skip

Cron setup (macOS LaunchAgent)

<!-- ~/Library/LaunchAgents/com.yourname.langfuse-backup.plist -->
<key>StartCalendarInterval</key>
<dict>
  <key>Hour</key><integer>2</integer>
  <key>Minute</key><integer>0</integer>
</dict>
<key>ProgramArguments</key>
<array>
  <string>/bin/bash</string>
  <string>/path/to/scripts/backup_langfuse.sh</string>
</array>
<key>StandardOutPath</key>
<string>/tmp/langfuse-backup.log</string>

Restore procedure

# 1. Stop Langfuse
cd $LANGFUSE_COMPOSE_DIR && docker compose down

# 2. Restore from backup
bash scripts/restore_langfuse.sh 2026-02-27

# 3. Start Langfuse
cd $LANGFUSE_COMPOSE_DIR && docker compose up -d

---name: langfuse-backupdescription: Docker volume backup and restore for self-hosted Langfuse. Use when: backing up a self-hosted Langfuse instance, restoring Langfuse after a crash or migration, setting up daily cron backups for Langfuse postgres/clickhouse/minio/redis volumes. Backs up postgres (traces, scores), minio (blobs), with optional clickhouse and redis. Includes restore script with validation and 14-day retention pruning.---# langfuse-backupBackup and restore Docker volumes for a self-hosted Langfuse instance.## Scripts- `scripts/backup_langfuse.sh` — back up postgres + minio volumes (primary data)- `scripts/restore_langfuse.sh` — restore from a specific backup date## Quick start```bash# Configure (env vars or edit the script defaults)export LANGFUSE_BACKUP_DIR="$HOME/.langfuse-backups"export LANGFUSE_COMPOSE_DIR="/path/to/langfuse" # directory with docker-compose.ymlexport LANGFUSE_DB_CONTAINER="langfuse-db-1" # postgres container nameexport LANGFUSE_MINIO_CONTAINER="langfuse-minio-1" # minio container nameexport LANGFUSE_DB_NAME="langfuse" # postgres database nameexport LANGFUSE_DB_USER="langfuse" # postgres user# Run a backupbash scripts/backup_langfuse.sh# List available backupsls "$LANGFUSE_BACKUP_DIR"# Restore from a datebash scripts/restore_langfuse.sh 2026-02-27```## Env vars| Var | Default | Description ||---------------------------|--------------------------------------|-------------------------------------|| `LANGFUSE_BACKUP_DIR` | `~/.langfuse-backups` | Root backup directory || `LANGFUSE_COMPOSE_DIR` | `~/langfuse` | Docker Compose project directory || `LANGFUSE_DB_CONTAINER` | `langfuse-db-1` | Postgres container name || `LANGFUSE_MINIO_CONTAINER`| `langfuse-minio-1` | MinIO container name || `LANGFUSE_DB_NAME` | `langfuse` | Postgres database name || `LANGFUSE_DB_USER` | `langfuse` | Postgres user || `LANGFUSE_RETENTION_DAYS` | `14` | How many days of backups to keep |## What gets backed up| Volume | Backed up? | Notes ||-----------|------------|---------------------------------------------|| Postgres | ✅ Yes | `pg_dump` → `.sql.gz` — traces, scores, evals || MinIO | ✅ Yes | `tar.gz` — uploaded blobs || ClickHouse| ⚠️ Optional| Large; many users skip (replayed from traces)|| Redis | ⚠️ Skip | Cache only — safe to skip |## Cron setup (macOS LaunchAgent)```xml<key>StartCalendarInterval</key><dict> <key>Hour</key><integer>2</integer> <key>Minute</key><integer>0</integer></dict><key>ProgramArguments</key><array> <string>/bin/bash</string> <string>/path/to/scripts/backup_langfuse.sh</string></array><key>StandardOutPath</key><string>/tmp/langfuse-backup.log</string>```## Restore procedure```bash# 1. Stop Langfusecd $LANGFUSE_COMPOSE_DIR && docker compose down# 2. Restore from backupbash scripts/restore_langfuse.sh 2026-02-27# 3. Start Langfusecd $LANGFUSE_COMPOSE_DIR && docker compose up -d```

Frequently asked questions