Reference

Troubleshooting

Quick fixes for the issues we hear about most. If yours isn't here, reach out — we read everything.

Global shortcuts don't work

The most common cause is a Wayland session. ReticulOS's global shortcuts are fully supported on X11; on Wayland, the compositor controls global keybindings and native support is in development.

Check your session type: run echo $XDG_SESSION_TYPE in a terminal.
On GNOME: you can bind the toggle yourself — Settings → Keyboard → Custom Shortcuts, with the command pkill -o -SIGUSR1 reticulos-linux. This toggles the widget even where Electron's own shortcut registration can't.
Quick fallback: log into an "Xorg" / "X11" session from your login screen.

The widget seems to have disappeared

It's almost certainly toggled hidden — the toggle makes the widget fully invisible and click-through, in place. Press Ctrl+Shift+\ again, or right-click the tray icon and choose Show.

The app won't quit

Closing the window is intentional hide-to-tray behavior, not a quit. To exit completely, right-click the tray icon and choose Quit. (This is also why the widget survives closing every window — global shortcuts keep working.)

Selection capture (Ctrl+Shift+=) does nothing

It captures the current mouse selection (X11 primary selection), not the clipboard — select text first, don't copy it.
It requires xclip, which is installed automatically with the .deb. If you installed another way: sudo apt install xclip.
On Wayland sessions this path is limited — see the shortcuts issue above.

"Cannot unlock database" on startup

ReticulOS could not unlock your encrypted data with your system's secure login. This usually means that login changed — a reinstalled OS, a new user account, or a reset login password.

If your system login was reset, restore your system from a backup — your data is unreadable without it. That's the encryption working as designed.
If you upgraded from a pre-encryption version, the safety backup created during the upgrade can be recovered — contact support and we'll walk you through it.
If you just want a fresh start, reach out and we'll point you to the reset steps for your setup.

A second launch doesn't open a new window

By design — ReticulOS runs a single instance. Launching it again reveals and focuses the running widget; launching with --reticulum opens the workspace window instead.

Still stuck?

Head to Help & Support or email contact@reticulos.com with what you tried — screenshots help.