Migrate Projects and Users from one Langfuse env to another environment

[guptagaurav89]

Describe your question

Is there any mechanism to migrate projects and user from one UAT environment to PROD environment.

Langfuse Cloud or Self-Hosted?

Self-Hosted

If Self-Hosted

Yes

If Langfuse Cloud

No response

SDK and integration versions

No response

Pre-Submission Checklist

• I have checked for existing issues/discussions and consulted Langfuse AI.

[inkeep-ai-assistant[bot]]

Langfuse provides a Python-based migration guide for moving data between projects or environments(1).

Migrating Project Data

You can migrate traces, observations, scores, prompts, and datasets using the Langfuse Public API and Python SDK(1). The migration cookbook provides code to:

• Fetch data from the source Langfuse instance using API endpoints
• Recreate that data in the destination instance using the ingestion API(1)

The migration preserves original trace IDs to maintain data integrity(1).

User Migration

For user and organization setup in the destination environment, you can use headless initialization. This automates resource creation on startup using environment variables(2)(3).

Set these LANGFUSE_INIT_* environment variables to automatically create users, organizations, and projects(4)(2):

• LANGFUSE_INIT_ORG_ID - Organization identifier
• LANGFUSE_INIT_PROJECT_ID - Project identifier
• LANGFUSE_INIT_USER_EMAIL - Initial user email
• LANGFUSE_INIT_USER_PASSWORD - Initial user password
• LANGFUSE_INIT_PROJECT_PUBLIC_KEY - API public key
• LANGFUSE_INIT_PROJECT_SECRET_KEY - API secret key(4)

On startup, Langfuse creates these resources if they don't exist(2).

Important Notes

• There's no native one-click sync tool for full project migration(5)
• You must implement pagination and relationship mapping for large datasets(5)
• Rate limits apply: 1000 batches per minute, 5MB per request(5)
• For Teams/Enterprise plans, Langfuse offers migration support services(6)

Check out the migration cookbook for complete Python code examples(1).

📚 Sources:

1. Migrating Data from One Langfuse Project to Another
2. Headless Initialization of Self-Hosted Deployments - Langfuse
3. Administration Overview (self-hosted)
4. Deployment Guide (v2)
5. How to Migrate Project Data Between Isolated Langfuse Instances ?
6. Migrating from self-hosted to cloud: how?

---

Have another question? Just tag @inkeep.

[jannikmaierhoefer]

Hi @guptagaurav89, inkeep is correct. You can use our data migration script: https://langfuse.com/guides/cookbook/example_data_migration