← Back to Skills Marketplace
nissan

Langfuse Backup

by Nissan Dookeran · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ⚠ suspicious
428
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install langfuse-backup
Description
Docker volume backup and restore for self-hosted Langfuse. Use when: backing up a self-hosted Langfuse instance, restoring Langfuse after a crash or migratio...
README (SKILL.md)

Last used: 2026-03-24 Memory references: 2 Status: Active

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)

\x3C!-- ~/Library/LaunchAgents/com.yourname.langfuse-backup.plist -->
\x3Ckey>StartCalendarInterval\x3C/key>
\x3Cdict>
  \x3Ckey>Hour\x3C/key>\x3Cinteger>2\x3C/integer>
  \x3Ckey>Minute\x3C/key>\x3Cinteger>0\x3C/integer>
\x3C/dict>
\x3Ckey>ProgramArguments\x3C/key>
\x3Carray>
  \x3Cstring>/bin/bash\x3C/string>
  \x3Cstring>/path/to/scripts/backup_langfuse.sh\x3C/string>
\x3C/array>
\x3Ckey>StandardOutPath\x3C/key>
\x3Cstring>/tmp/langfuse-backup.log\x3C/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
Usage Guidance
This script bundle appears to be what it says: a local Docker-volume backup/restore for Langfuse. Before installing or running: (1) review the two shipped scripts yourself — they will drop/create the DB and overwrite MinIO data during restore; (2) ensure you have docker and python3 available (the backup script invokes python3 for manifest generation); (3) be aware docker run --rm alpine ... will pull the alpine image from Docker Hub if it isn't already present, so the claim "outbound: false" is optimistic unless you pre-pull images or are offline; (4) test in a non-production environment first and confirm LANGFUSE_COMPOSE_DIR and container names match your setup; (5) backups and pruning use the backup directory you specify — verify its path and permissions to avoid accidental deletion of other data. If you need strict no-network guarantees, either pre-pull required images (alpine) and ensure no image pulls are necessary, or review/modify the scripts to avoid docker run image pulls.
Capability Analysis
Type: OpenClaw Skill Name: langfuse-backup Version: 1.0.2 The skill provides legitimate utility for backing up and restoring self-hosted Langfuse Docker volumes. The scripts (backup_langfuse.sh and restore_langfuse.sh) use standard Docker commands (pg_dump, tar) and local filesystem operations to manage data, with no evidence of data exfiltration, obfuscation, or unauthorized access.
Capability Assessment
ℹ Purpose & Capability
The skill's name, description, and scripts align: it performs local Docker-based backups and restores of Postgres and MinIO volumes. Requiring the docker binary is appropriate. Minor mismatch: the backup script invokes python3 to build the manifest but python3 is not listed in required binaries, and the restore/backup use docker run alpine which will pull an image if not present (implying transient network access).
⚠ Instruction Scope
The SKILL.md and included scripts stay within the stated scope (reading Docker volumes, creating local tar/gzip dumps, writing backups to a user-specified local directory). However: (1) the scripts create a manifest that includes hostname and timestamps (identifying metadata) which some users may not expect, (2) docker run --rm alpine ... will pull the alpine image if absent, causing outbound network activity despite the metadata claiming outbound: false, and (3) restore script will drop/create the database and overwrite data — destructive operations that require explicit user awareness and confirmation (the script prompts but will proceed if confirmed).
✓ Install Mechanism
Instruction-only skill with two shell scripts; there is no install spec and nothing is written to disk by an installer. This minimizes install-time risk.
✓ Credentials
No credentials or secrets are requested. The scripts accept a handful of environment variables for configuration (backup dir, container names, DB name/user), which are reasonable and proportional to the task.
✓ Persistence & Privilege
always is false and the skill does not attempt to modify other skills or global agent settings. The scripts do require local Docker privileges (expected for a Docker-volume backup/restore tool) and will start/stop containers as part of restore operations.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install langfuse-backup
  3. After installation, invoke the skill by name or use /langfuse-backup
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
Added metadata.openclaw block and version field — scanner compliance
v1.0.1
Added version, metadata.openclaw, and docker bin declaration
Metadata
Slug langfuse-backup
Version 1.0.2
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 2
Frequently Asked Questions

What is 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 migratio... It is an AI Agent Skill for Claude Code / OpenClaw, with 428 downloads so far.

How do I install Langfuse Backup?

Run "/install langfuse-backup" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Langfuse Backup free?

Yes, Langfuse Backup is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Langfuse Backup support?

Langfuse Backup is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Langfuse Backup?

It is built and maintained by Nissan Dookeran (@nissan); the current version is v1.0.2.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments