Troubleshooting

Memos

White screen or plain-text error

If you encounter an error while the Memos page is loading, or if it remains blank, press F5 or right-click the window and select ‘Reload’.

This is caused by a stale WebView cache and also affects Memos’ Docker instances. It’s more likely to happen right after an update.

Updates

Updater errors

The easiest way to solve update issues is to download the latest release from the releases page and install it over your current version.

If the auto-updater isn’t working for your setup and the notifications are annoying, you can delay checks or disable the updater entirely in Configuration (see memospot.updater).

Memos server update issues

If the updater fails to replace memos:

1. Terminate memos and memospot processes:
   Windows

   [System.Diagnostics.Process]::GetProcesses() | Where-Object {
     $_.ProcessName -in "memospot", "memos"
   } | Stop-Process -Force -ErrorAction SilentlyContinue

   Linux/macOS

   killall memospot memos

2. Retry the update.

Linux-specific

For general Linux troubleshooting, run the app in the terminal to see any error messages:

memospot

Heuristic environment variables

Memospot automatically tries to detect the best settings for your system. You can check current environment variables by enabling and inspecting the log file.

You can unset any internal environment variables by defining them again with an empty value, like FLAG= (configuration screen) or FLAG: "" (memospot.yaml).

Making flags permanent

If one of the following flags resolves your issue, set it in memospot.env.vars.

White screen or hanging on loading

If you encounter this issue, it may be due to a problem with hardware acceleration in your GPU driver. This is a common issue with Linux virtual machines.

Run the app with the WebView acceleration disabled (software rendering):

WEBKIT_DISABLE_COMPOSITING_MODE=1 memospot

Sluggish scrolling or typing with NVIDIA GPUs

Run the app with explicit synchronization disabled:

__NV_DISABLE_EXPLICIT_SYNC=1 memospot

EGL display-related errors

Run the app forcing the X11 backend:

GDK_BACKEND=x11 memospot

Other graphical issues

Run the app disabling the DMABuf renderer:

WEBKIT_DISABLE_DMABUF_RENDERER=1 memospot

GLIBC errors

You’ll have to upgrade your distribution.