Migrate from v1.x Local Database to v2.x

LobeHub v1.x Desktop offered a local database mode — your data lived on your device. Starting with v2.x, we moved to a cloud-first architecture and removed the local database. The result: a lighter client, faster iteration, and a consistent experience across browser, desktop, and mobile.

<Callout type="info"> **Why the change?** The v1.x local database consumed more system resources, and only a small portion of users relied on it. By simplifying the client and focusing on cloud-first, we improve performance and ship new features faster. </Callout>

This guide walks you through exporting from v1.x and importing into v2.x. Your Agents, conversations, and settings can all move over — typically in a few minutes.

Before You Start

• Keep v1.x installed until you've confirmed the migration worked.
• Use a stable network — importing can take a while if you have a large history.
• Sign in to v2.x — Cloud (app.lobehub.com) or your self-hosted instance.

Prefer to self-host? Deploy v2.x first using the Self-Hosting Guide, then import your data into that instance.

If You Already Upgraded to v2.x

You can still migrate. Your local database files are not deleted when you upgrade — they remain on disk until you remove them.

1. Download a v1.x build from GitHub Releases.
2. Install and open v1.x, then export your data: Settings → Data Storage → Export Data.
3. In v2.x, go to Settings → Data Storage → Import Data and upload the export file.

Where Is the Local Database?

By default, the v1.x local database is stored at:

• Windows: %APPDATA%/lobehub-storage/lobehub-local-db
• macOS: ~/Library/Application Support/lobehub-storage/lobehub-local-db

If you need to recover data manually, these paths may be useful.

What Gets Migrated

Depending on your v1.x build and export format, you can typically migrate:

Item	Migrated
Agents	Yes — names, prompts, model settings
Conversations & Topics	Yes — messages and topic structure
Prompt templates	Yes, if your v1.x build supported them
Basic preferences	Yes — language, theme, shortcuts (when supported)

What Does Not Migrate

Item	Notes
API keys and secrets	Re-enter them in v2.x for security. v2.x uses a different storage model.
Local-only files / cache	Temporary data that doesn't apply to cloud.
Device-specific settings	Some settings are tied to the old local setup.

<Callout type="warning"> If your export contains sensitive content, store the file securely. Do not share it publicly or commit it to version control. </Callout>

Step 1: Export from v1.x

In the v1.x Desktop app:

1. Go to Settings → Data Storage → Export Data.
2. You'll get a JSON file (e.g. 2026-01-22-10-02_LobeHub-data.json).
3. Save it somewhere easy to find — Desktop or a dedicated folder.

Tips:

• Large histories can take a few minutes to export. Run the export when your device is idle.
• Keep the file until you've verified the import in v2.x.

Step 2: Import into v2.x

In any v2.x app (Desktop, Web, or self-hosted):

1. Sign in to your LobeHub account.
2. Go to Settings → Data Storage → Import Data.
3. Upload the JSON file from Step 1.
4. Wait for the import to finish. Refresh the page or restart the app if the UI doesn't update.

Tips:

• Don't close the app or navigate away during import. Let it complete.
• If you have multiple v1.x profiles or workspaces, export each separately and import one at a time (when your v1.x build supports it).

Verify Your Migration

After importing, spot-check:

• Agents — All present? Prompts and model settings correct?
• Conversations — Recent Topics and messages load as expected?
• Settings — Language, theme, shortcuts match your preferences?

If something is missing, keep the v1.x export file. Update to the latest v2.x, then try importing again. The export format may have improved in newer versions.

Troubleshooting

Import fails or hangs

• Check your network — A stable connection is required. Try again on a different network if possible.
• Update v2.x — Use the latest version; import logic is improved over time.
• Reduce scope — If you have multiple exports, try importing a smaller one first to isolate the issue.

Some data is missing after import

• Different v1.x builds — Data structure can vary between v1.x versions. Re-export from the same build you've been using.
• Multiple profiles — If you used multiple profiles or workspaces in v1.x, export each separately and import one by one.

Export file is very large

• Large exports are normal if you have many conversations. Import may take several minutes. Be patient and keep the tab/app open.

Getting Help

If you run into issues:

• Help & Support — General resources and community links
• GitHub Issues — Report bugs or request help with migration

Include your v1.x version, v2.x version, and a description of what went wrong. If possible, note whether the export completed successfully and where the import failed.