Memospot is a self-contained desktop version of Memos, a beautiful, privacy-first, lightweight note-taking service.

This project is designed for people who:

• Are new to Docker
• Prefer not to host Memos themselves
• Wish to run Memos on their local machine with no Docker overhead
• Are interested in testing Memos before spinning up a Docker instance.

• Easy to install and use
• Bundled Memos server build, based on official release tags
• Automated server startup and shutdown
• Internal Memos server listens only on localhost, at a random port

• Windows 10, macOS, or Linux
• System WebView (Edge, Safari, or WebkitGTK).
• Memos (bundled)

On Windows, you will be prompted to install WebView2, if it's not available.

Download the latest release for your platform from the releases page.

• On Windows, you may get a warning from Windows Defender SmartScreen. This is because the app is not signed. Just click More info and Run anyway.
• On macOS, you may need to allow the app to run first.

If Memospot starts but doesn't get past the loading screen, or the screen stays white, you may have an issue with hardware acceleration on your GPU driver. Try disabling the WebView acceleration with the following command:

echo 'WEBKIT_DISABLE_COMPOSITING_MODE=1' | sudo tee -a /etc/environment
# You must restart your computer for this to take effect

Download the latest server release from memos-builds and replace the memos binary in the installation folder.

Note that while this works on most cases, it's discouraged for anything other than patch version upgrades (version scheme is Major.Minor.Patch).

Manual server update can break things, and you can't easily go back to the previous version due to database changes that usually happen between major and minor versions. If you need to revert an update, you'll have to restore a database backup.

Open Powershell and run the following command:

Set-ExecutionPolicy Bypass -Scope Process -Force; iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/lincolnthalles/memospot/main/memos-server-updater.ps1'))

If you plan to move your Memos instance to Docker in the future, keep the object storage setting at the default option Database for a drop-in migration. Just move memos_prod.db to the Docker volume and that's it.

Although, if you are storing huge files, it's a good idea to use Local Storage instead, even with this trade-off.

Data storage:

• Windows: data is stored under %AppData%\memospot
• POSIX systems: data is stored under ~/.memospot

This project is made possible by the following open-source projects: