Skip to content

Notebook Data and Migration

Mathcha Notebook stores your library in a single file named database.sqlite. It contains your documents, folder hierarchy, embedded images, saved document history, and editor settings. The folders shown in Notebook are part of this database, rather than separate folders on your computer.

Transferring this file transfers your library, including when moving between Windows, macOS, and Linux. Application data-location preferences and automatic backup files are stored separately.

Open Menu > User Settings and click Open beside Data Location. The folder that opens contains database.sqlite. Use this method if you have changed the data location.

The usual locations are:

PlatformDatabase file
Windows%APPDATA%\Mathcha Notebook\db-data\database.sqlite
macOS~/Library/Application Support/Mathcha Notebook/db-data/database.sqlite
Linux~/.config/Mathcha Notebook/db-data/database.sqlite

On Windows, paste the path into File Explorer’s address bar. On macOS, use Finder’s Go > Go to Folder. On Linux, enter the path in your file manager; the location can differ with XDG_CONFIG_HOME or packages such as Snap, so check Data Location for the actual folder.

If accessing another computer’s drive, look under that computer’s user profile. %APPDATA% and ~ otherwise refer to the current user.

  1. Install the latest Mathcha Notebook on the destination computer and open it once.
  2. Find Data Location on each computer as described above. Note both folders.
  3. Fully quit Notebook on both computers before copying the database.
  4. Back up any existing database.sqlite on the destination, then copy the source database.sqlite into the destination’s Data Location, keeping the same filename.
  5. Open Notebook on the destination and check your documents, folders, and images. Keep the original file until you have verified the transfer.

Replacing the database replaces the destination library; it does not merge libraries. To add selected documents to an existing library, use .mathcha export and import instead.