First Run & Vault Setup
What happens the first time you open memrynote on a computer: a short setup that picks your look, your modules and where your notes live, then opens the app.
The whole flow takes about two minutes. If you turn on sync, the most important step is saving the recovery phrase. Read on for why.
Setup on a New Install
When memrynote knows no vaults on this computer, it opens the setup. Every screen works from the keyboard: ↑ and ↓ move between options, ↵ continues and Esc goes back a step. The dots at the top show how many steps are left. The language picker on the welcome screen switches the whole setup at once.
Choose Get started to set up a new space, or Sign in under "Already use MemryNote?" to bring an existing account's notes onto this computer (see Signing In on Another Computer).
| Step | What you choose |
|---|---|
| Theme | System, White, Light (the Warm theme) or Dark. More themes below the cards offers the editor themes from Settings (Nord, Dracula and the rest); picking one while Light is selected switches to White, since those themes have no Warm side. The setup repaints as you choose. |
| Modules | Which parts of memrynote you use: Home, Inbox, Journal, Tasks, Calendar, Graph, Spatial canvas and AI. Notes are always on. The preview under the list shows the module you point at, and drops a module from the app's rail as you turn it off. |
| Import | Where to bring notes from. Obsidian vaults found on this computer are listed first, then Apple Notes and Notion, and the rest after them. Importers for a module you turned off are hidden: no Todoist or TickTick without Tasks, no NotePlan or Apple Journal without Journal. |
| Agent | Shown only with AI on. Which agent memrynote talks to: Claude Code, Codex, Antigravity or a local model (Ollama, LM Studio). Agents found on this computer can be picked; the others offer an install link. The on-device smart connections model starts downloading when you continue. |
| Storage | Only on this Mac (or "this computer" on Windows and Linux) keeps everything local. Sync across my devices continues to an account and a plan. |
| Ready | A last look: the notes folder (default ~/Documents/Memry/My notes), the imports that will run, the model download, and whether to share anonymous usage metrics (on unless you turn it off). Open MemryNote creates the folder and opens the app. |
Nothing is written until Open MemryNote. The imports and the model download keep running after the app opens, and a message says when each import finishes or fails.
Use an existing folder on the Ready screen opens a folder you already have. A folder that is already a memrynote vault keeps its own settings: the theme, modules and imports you picked in setup are not applied to it.
The setup replaces the sidebar tour, so the tour does not run afterwards.
Sync, Account and Plan
With Sync across my devices, setup asks for your email and a six-digit code, then shows a new account's 24-word recovery phrase and asks for three of its words back (see Recovery Phrase). If the email already has an account, setup switches to unlocking that account on this computer instead.
Next comes the plan: Plus, Pro or Believer, monthly or yearly. Continue to checkout opens the payment page in your browser with that plan already chosen. Setup waits for the payment and moves on by itself once it goes through. Not now continues without a plan: everything stays on this computer, and the Ready screen offers Choose a plan to go back. Plans and prices are on memrynote.com/pricing.
Signing In on Another Computer
Sign in on the welcome screen is for an account you already use. After the email code, this computer needs one of your keys: approve it from a device you already use (Settings → Account → Link new device) or enter your recovery phrase. Then pick the vault to download and where to put it. An account with a single vault skips the choice and downloads it into ~/Documents/Memry. An account with no vaults yet continues to the setup steps above, with sync already on.
A vault you download brings its own synced settings, so it opens the way it looks on your other devices.
With Continue with Google, MemryNote keeps the sign-in session open while you use your browser. If the browser does not open, choose Copy sign-in link and paste the link into a browser on the same computer. Try opening browser again retries the same session. Use another sign-in method returns to email sign-in. An expired session needs a new sign-in.
The default download location uses your system's Documents folder, which can differ from ~/Documents on Linux. When a vault is already open, new vaults default to its parent folder. Check the destination shown before downloading. If a download fails, the setup shows the reported cause. Native database loading failures do not create a new vault folder. Empty directories from a failed creation attempt are removed, but partial databases and other files are kept.
Computers That Already Have Vaults
A vault is a folder of Markdown files on disk. memrynote keeps its databases, attachments, and CRDT state in a hidden .memry folder inside it.
When this computer already knows a vault, memrynote shows the vault picker instead of the setup. It offers three ways in:
| Option | Shortcut | What it does |
|---|---|---|
| Create new vault | ⌘+N | Enter a name and a location (default ~/Documents/Memry). memrynote creates the folder <location>/<name> and opens it. An existing folder is never reused silently. |
| Open folder as vault | ⌘+O | Pick a folder of Markdown files you already keep. memrynote works on the files where they are. |
| Open from Memrynote Sync | ⌘+L | Sign in (or create an account), unlock with your recovery phrase or a linked device, then pick one vault from your account to download. |
On Windows and Linux the shortcuts use Ctrl.
If Create new vault finds a folder with that name already at the location, it offers to open that folder as a vault instead.
When Open folder as vault picks an Obsidian vault that memrynote has never opened, memrynote first offers to open a copy of it, <name>-memrynote, so the original stays exactly as Obsidian left it. Import from Obsidian Tasks explains why, and what each choice does.
Open from Memrynote Sync lists your account's vaults by name. Choose one and where it should be downloaded; a vault that is already on this computer opens its local copy. The other vaults stay in your account and can be downloaded later from the vault switcher. A new account with no vaults continues to Create new vault.
Pick a location of your own if you want to:
- Sync the vault itself with iCloud / Dropbox (not recommended — sync conflicts with memrynote's own sync; use memrynote sync instead)
- Place it on a specific drive
- Keep it in a folder you back up separately
You can move the vault later from Settings → Vault.
The Sandbox Vault
A new vault is empty, which makes it hard to judge what memrynote can do. The sandbox vault is a ready-made vault full of notes, journal entries, projects, tasks, calendar events, inbox items and files, so you can look around before you fill your own.
Open the vault switcher and choose Try the sandbox vault. It sits in a section of its own, between your vaults and Open vault. The first time, memrynote builds it on your computer, which takes a few seconds, and then switches to it. Dates in the sandbox are relative to the moment it is built, so there are tasks due today, overdue items and an unbroken journal streak.
The sandbox is not one of your vaults:
- It is stored in memrynote's own data folder, never in a folder you chose.
- It never syncs, so nothing in it reaches your account or your other devices.
- It does not appear in the sidebar's swipe between vaults, and it cannot be removed from the switcher.
- Quitting memrynote while it is open brings you back to your own vault on the next launch.
To leave, press the back arrow in the sidebar header, which returns to the vault you opened last, or pick another vault in the switcher.
Changes you make in the sandbox are yours to keep until memrynote updates. Each new app version rebuilds the sandbox, so edits are lost then. To start over earlier, leave the sandbox, open the switcher, and use the reset button that appears when you hover the sandbox row.
Setting a Passphrase
Your passphrase encrypts the vault's wrapping key locally and is required at every sign-in.
Pick something:
- Long (passphrases > passwords; consider four random words)
- Memorable to you
- Not used anywhere else
memrynote hashes the passphrase with Argon2id + a per-vault salt to derive the wrapping key. The passphrase itself never leaves your device.
You'll be asked to confirm by re-entering it.
Recovery Phrase
This is the most important step.
memrynote generates a list of words derived from the same vault entropy. The phrase is the only way to decrypt your data if you:
- Forget your passphrase
- Lose every device that has the vault key sealed for it
Save it somewhere durable:
- A password manager (recommended)
- Written down in a safe place
- Printed and stored physically
Do not screenshot it on a synced phone, email it, or paste it in a notes app.
The phrase screen shows the 24 words in numbered columns, with Copy and Download buttons. Download saves memrynote-recovery-phrase.txt, one numbered word per line; move it somewhere offline and delete the copy in Downloads. The copied phrase is cleared from the clipboard after 30 seconds.
After showing the phrase, memrynote asks you to re-enter three specific words to confirm you've saved it. ↵ verifies and Esc goes back to the phrase. This step exists to prevent accidental loss. Setup and Settings → Account show the same two screens.
If you close Settings during this confirmation step, signup stays incomplete. Reopen Settings → Account to resume recovery confirmation before sync starts.
Email & OTP (Optional, for Sync)
If you want sync, memrynote asks for an email and verifies it with a six-digit one-time code.
The code arrives from MemryNote (noreply@memrynote.com) with the subject "Your MemryNote verification code". If it doesn't show up within a minute or two, check your spam folder.
You can skip sync entirely — choose Continue without sync to stay fully local. You can enable sync later from Settings → Account.
What Gets Created
After setup completes, your vault directory looks like this:
<vault>/
├─ data.db # primary SQLite database
├─ data.db-wal
├─ index.db # search / graph / embedding index
├─ index.db-wal
├─ attachments/ # file payloads
├─ leveldb/ # y-leveldb store for Yjs CRDT state
└─ vault.json # public metadata (version, salt — not the key)All the heavy data is encrypted at rest with the vault key. The salt and version metadata are not sensitive.
Onboarding Tour
A vault opened from the vault picker gets a brief in-app tour pointing out the sidebar, tabs, and search. Click through or skip — you can revisit it via the keyboard shortcuts dialog.
The tour counts as seen once you finish it, skip it, or close it. If it never got that far — you quit the app while the tour was still on screen — it is not counted, and memrynote offers it again on the next launch. Either way it opens the right-hand Day Panel so the calendar and Agent steps have something to point at, and leaves it open afterwards.
The record that you have seen the tour is saved in the vault's own settings, so it survives app updates and reinstalls. The tour is also skipped for any vault that already holds notes, because that vault is not new, and for a vault set up through the first-run setup, which covers the same ground.
Next Steps
- Take a Tour of memrynote
- Open the User Guide and start with Notes
- If you set up sync, link another device