Back Up, Export, and Move Your Data
Back up your full app data, export chats, and move to another computer.
Follow the bold button names and numbered steps. Technical names are included only when you need to recognize a model or file inside the app.
Local Waifu offers three different data operations. They are not interchangeable.
| Operation | Contains | Best use | Can it restore the whole app automatically? |
|---|---|---|---|
| Make a backup | Snapshot of the Local Waifu app data directory, including database, soul files, history, and settings | Recovery copy before an update or support-assisted restore | No. Version 1.8.0 has no button that replaces your live data with a backup. Restore a backup only checks a backup by copying it into a new folder |
| Export Conversations | Chat-message records in JSON | Reading, archiving, or processing messages | No; there is no general conversation-import control in this panel |
| Character export | One character plus related messages, memories, relationship data, and knowledge entities | Supported self-service transfer to another installation | Imports as a new character; it is not a full-app restore |
Create a full backup snapshot
Goal
Create a consistent copy of the Local Waifu application data before a major update, reset, repair, or computer migration.
Before you start
- Choose a destination outside the Local Waifu data directory, preferably another drive or a synced backup location.
- Make sure the destination has enough free space.
- A full backup can contain private conversations, images, voice references, settings, and secrets. Store it securely.
Steps
- Open Settings → Advanced.
- Review Data health and resolve a reported integrity problem before relying on a new backup. It reads Healthy with the size on disk when all is well. On macOS the block is headed Backup & safety. On Windows the same block is headed Make a backup, and the conversation export block is headed Export Conversations instead of Data Export.
- Find Make a backup and select Choose folder.
- Pick an existing destination folder outside Local Waifu’s app data directory.
- Wait until the row reports Saved, a file count, and a total size.
- In the destination, confirm that a new folder named
local-waifu-backup-<timestamp>exists. - Copy the backup to a second protected location if it is your only recovery copy.
Expected result
Local Waifu creates a timestamped folder and a consistent SQLite snapshot. Temporary SQLite WAL/SHM files are not required in the backup.
If something goes wrong
- If the app reports that the destination overlaps Local Waifu’s data directory, choose another folder or drive.
- If the copy stops, check free space and destination permissions, then use Backup again.
- Do not judge success only by the folder’s existence; confirm the in-app file count and size.
Restore warning: Local Waifu 1.8.0 does not provide a button that replaces your live data with a backup. Do not copy a backup over the live data directory while the app is running. For full restoration, quit the app and obtain a version-appropriate support procedure. A manual replacement may fail if encryption or machine-bound data no longer matches.
Check that a backup is usable
Goal
Find out whether a backup would work without touching your current data.
Steps
- Open Settings → Advanced and find Restore a backup.
- Select Restore into a folder.
- Choose the finished backup folder (Choose the finished backup folder).
- Choose a new or empty folder (Choose a new or empty folder) outside your live data.
- Wait for the result.
Expected result
The panel reports Restored N files with the size, the number of characters, messages, and media files, and N / M soul files verified. A green result means the backup can be read.
If something goes wrong
- This is a check, not a restore. Your current data is never touched or replaced. The app refuses an existing non-empty folder, a folder that overlaps your live data, and your live profile itself.
- Some soul files could not be verified means a backup is incomplete or its encryption does not match. Keep it unchanged and contact support.
- This backup contains no soul files to verify is shown when the backup has none.
- The restored folder is a normal copy. Delete it when you are finished.
Export all conversations
Goal
Save chat messages as a JSON file for archive or analysis.
Before you start
This export is not a backup. It does not include the complete character, memories, soul files, models, credentials, or settings, and the same panel has no general import function for this file.
Steps
- Open Settings → Advanced → Data Export.
- Select Export Data beside Export Conversations.
- Choose a new
.jsonfilename and location outside the Local Waifu data directory. - Wait for Saved!.
- Keep the file private; message content is readable JSON.
Expected result
A file named like localwaifu-export-YYYY-MM-DD.json contains the exported message records.
If something goes wrong
- Choose an absolute path ending in
.json. - Do not select the Local Waifu data directory.
- Choose a new name; the exporter refuses to overwrite an existing export.
Move a character to another computer
Goal
Use the supported character export/import path for a self-service migration.
Before you start
- This transfers the exported character and related messages, memories, relationship data, and knowledge entities. Knowledge entities arrive without the relationships between them; those are re-extracted as you keep chatting.
- It does not transfer installed models, provider keys, connected accounts, the Telegram token/pairing, app-level preferences, or the Direct license activation.
- The imported character is created as a new character; it does not overwrite an existing one.
Steps
- On the old computer, open Settings → Characters.
- Export the character and save the generated
.jsonfile. - Transfer that file securely to the new computer.
- Install and complete onboarding in Local Waifu on the new computer.
- Open Settings → Characters and import the character JSON.
- Confirm the reported counts for messages, memories, and knowledge entities.
- Reinstall the required chat, embedding, image, and voice models.
- Re-enter cloud API keys or reconnect accounts.
- Configure Telegram again with Settings → Telegram.
- If using the Direct edition, redeem the same key on the new computer. There is no device limit, so there is nothing to deactivate on the old one.
- Continue using the imported character and confirm that she recalls the imported memories.
Expected result
A new character appears with the exported history and character-related data. Recall of the imported memories works immediately on macOS, which restores their stored semantic vectors. On Windows the imported memories carry no vectors, so only memories created after the import take part in semantic recall and the older ones stay reachable through the Memory Book and keyword matching.
If something goes wrong
- Import failed means the JSON is damaged or incompatible; export it again from the source installation.
- If recall of the imported memories is weaker than on the old computer, keep the required memory model installed and keep chatting: on macOS this settles as the conversation continues, and on Windows the imported memories rely on keyword matching.
- If you need complete app recovery rather than a character transfer, preserve the full backup and contact support. 1.8.0 has no button that replaces live data with a backup.