Migrate & Restore
Migrating your Denjin app settings from one device to another
If you are switching computers and want to migrate your Denjin app settings from one device to another, follow this guide.
Denjin App Data Directory
The Denjin 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
Important: Always back up your existing settings before migrating. This process will overwrite your current Denjin settings on the destination computer.
This migration only transfers your Denjin app settings and
configuration. Your actual Denjin app code (located in
~/dyad-apps
or
C:\Users\[YourUsername]\dyad-apps
) must be
copied separately if needed.
Migrate Settings
Step 1: Export from your old computer
- On your old computer, navigate to the Denjin App Data Directory using the instructions above
-
Copy these two files:
sqlite.db
user-settings.json
Step 2: Import to your new computer
- On your new computer, make sure Denjin is closed and navigate to the Denjin App Data Directory
-
Back up your existing files first: Copy the
existing
sqlite.db
anduser-settings.json
to a safe location - Paste the files you copied from your old computer
- When prompted, choose to overwrite the existing files
Step 3: Open Denjin
Open Denjin to load your migrated settings.
Restoring Settings from Backup
If you need to restore your Denjin app settings due to a bad upgrade or other issues, Denjin automatically creates backups during upgrades.
Finding Your Backups
- Navigate to your Denjin App Data Directory
- Open the
backups
folder -
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 Denjin 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
- Make sure the Denjin app is closed
- Choose the appropriate backup folder based on when you want to restore from
-
Copy
sqlite.db
anduser-settings.json
from that backup folder - Navigate back to your main Denjin App Data Directory
- Back up your current files first (in case you need to undo this)
- Paste the backup files, overwriting the existing ones
- Open Denjin to load the restored settings