Getting Started
Installation
ReticulOS ships as a native Debian package for Linux. Installation takes under a minute.
Requirements
| Requirement | Details |
|---|---|
| Operating system | A Debian or Ubuntu based Linux distribution (Ubuntu 22.04+ recommended) |
| Display server | X11 for full functionality. On Wayland sessions some capture shortcuts are limited — see Troubleshooting. Wayland support is in development. |
| Architecture | 64-bit (amd64) |
| Dependencies | xclip, xdg-utils, libnotify4 — declared by the package and installed automatically |
Installing the package
Download the latest .deb from the download page, then install it with apt so dependencies are resolved automatically:
sudo apt install ./reticulos-linux_v0.8.0_amd64.deb
That's it. ReticulOS appears in your application menu.
Tip: If you double-click the .deb instead, your distribution's software installer will handle it the same way.
Launching
| How | What opens |
|---|---|
| App menu / launcher | The widget, floating at the top-right of your primary screen |
reticulos-linux | Same as above; if ReticulOS is already running, the existing widget is revealed and focused instead of starting a duplicate |
reticulos-linux --reticulum | Opens Reticulum, the full workspace, directly |
On first launch, ReticulOS sets up its local database and encryption automatically. You don't need to configure anything.
Running in the tray
ReticulOS is designed to be always available. Closing the widget window hides it — the app keeps running in the system tray so your global shortcuts continue to work. To exit completely, right-click the tray icon and choose Quit.
Updating
Download the newer .deb and install it the same way — your data, collections, and settings are preserved. Database upgrades (like the encryption migration introduced in v0.8.0) run automatically on first launch, with a backup created beforehand. See Data & Storage for details.
Uninstalling
sudo apt remove reticulos-linux
Your data is never deleted by an uninstall — it stays safely in your home folder, so reinstalling later picks up right where you left off.