Migrate & Restore

If you are switching computers and want to migrate your Dyad app settings from one device to another, follow this guide.

Dyad App Data Directory

The Dyad App Data Directory contains your app settings and configuration files. The location varies by operating system:

Windows

• Path: C:\Users\[YourUsername]\AppData\Roaming\dyad
• To access: Press Windows + R, type %APPDATA%\dyad, and press Enter

macOS

• Path: ~/Library/Application Support/dyad
• To access: In Finder, press Cmd + Shift + G, type ~/Library/Application Support/dyad, and press Enter

Linux

• Path: ~/.config/dyad
• To access: Open your file manager and navigate to your home folder, then show hidden files and go to .config/dyad

This directory contains important files like sqlite.db (your app database) and user-settings.json (your configuration settings), as well as a backups folder for automatic backups.

Before You Start

Migrate Settings

Step 1: Export from your old computer

1. On your old computer, navigate to the Dyad App Data Directory using the instructions above
2. Copy these two files:
   • sqlite.db
   • user-settings.json

Step 2: Import to your new computer

1. On your new computer, make sure Dyad is closed and navigate to the Dyad App Data Directory
2. Back up your existing files first: Copy the existing sqlite.db and user-settings.json to a safe location
3. Paste the files you copied from your old computer
4. When prompted, choose to overwrite the existing files

Step 3: Open Dyad

Open Dyad to load your migrated settings.

Restoring Settings from Backup

If you need to restore your Dyad app settings due to a bad upgrade or other issues, Dyad automatically creates backups during upgrades.

Finding Your Backups

1. Navigate to your Dyad App Data Directory
2. Open the backups folder
3. You'll see folders with names like: v0.15.0_2025-08-04T18-19-36-266Z_upgrade_from_0.15.0-beta.2

Understanding Backup Folder Names

The folder name format is: [New Version]_[Timestamp]_upgrade_from_[Old Version]

For example: v0.15.0_2025-08-04T18-19-36-266Z_upgrade_from_0.15.0-beta.2 means:

• v0.15.0: The version Dyad upgraded to
• 2025-08-04T18-19-36-266Z: Date and time of the backup
• 0.15.0-beta.2: The version you upgraded from

Restoring from Backup

0. Make sure the Dyad app is closed
1. Choose the appropriate backup folder based on when you want to restore from
2. Copy sqlite.db and user-settings.json from that backup folder
3. Navigate back to your main Dyad App Data Directory
4. Back up your current files first (in case you need to undo this)
5. Paste the backup files, overwriting the existing ones
6. Open Dyad to load the restored settings