Backups and exporting

Mochi is an offline first application. This means that every piece of content that gets added or changed is saved locally to your device first, before it is synced to the cloud. Keeping your data safe is important, and Mochi provides two reliable ways to back up your information: backing up your user directory or creating an export file. Both methods preserve your cards, templates, review history, and attachments. This page walks you through each option and explains when you might use one over the other.

Backing up your user directory

The simplest way to back up everything is to copy the entire Mochi user directory from your computer. This folder contains all of your local Mochi data, including:

  • Content (Decks, Cards, Templates, etc)
  • Review history
  • Attachments (images, audio, etc.)
  • App settings
  • Login state (not password)

You can copy this folder to another location (such as an external drive or a cloud storage service) as a full backup.

User directory locations

The directory can be found in the following locations depending on your operating system:

  • Windows: %APPDATA%\Mochi

  • macOS: ~/Library/Application Support/Mochi

  • Linux: $XDG_CONFIG_HOME/mochi or ~/.config/mochi

Once located, simply copy the entire Mochi folder to a safe place. To restore from this type of backup, replace the folder with your saved version while Mochi is closed.

Tip

This method is best if you want a complete, restorable snapshot of all your local Mochi data.

Likewise if you delete this directory, that will effectively reset Mochi back to a fresh install. This might be useful for example if you want to sign in using a different account.

Export from the app

Mochi can also create export files directly from the app. These exports collect your data into a single .mochi file, which contains:

  • Deck(s)
  • Cards
  • Templates
  • Review history
  • Tags, links, and metadata
  • All attached files

Exports are portable, easy to move between devices, or between users.

Export everything

To export your entire workspace:

  1. Open Mochi.
  2. Click Settings in the side navigation.
  3. Click Export everything.

Mochi will generate a .mochi file containing all of your data.

You can store this file anywhere you like or import it back into Mochi later from a fresh install.

Export a single deck

If you only want to back up or share a single deck:

  1. Open the deck.
  2. Click the () menu.
  3. Select Export deck.

This creates a .mochi file containing only that deck, its cards, template(s) and attachments.

When to use exports:

  • Moving data between devices
  • Sharing a deck with someone else
  • Modifying your data outside of Mochi for re-import

Choosing the right backup method

Generally speaking, backing up the user directory is the simplest and easiest way to back up your data, while .mochi files or more intended for sharing data between users or devices.

Use case Recommended method
Full local backup of all data User directory backup
Cloud backup / periodic snapshots User directory backup
Moving data between devices Export .mochi file
Sharing a deck Export .mochi for a single deck