Installation and downloads

Actual availability

Linux x86_64 with Flatpak is the primary and recommended platform. Windows x86_64 is offered as an experimental ZIP with manual installation and updates. This website does not host binaries or announce Flathub availability.

Install your Flatpak bundle

With Flatpak and the required runtime available, run this from your checkout root with the freshly generated bundle. This is not a public download from this website.

flatpak install --user dist/umbral-linux-x86_64.flatpak
flatpak run io.github.martin08abm.umbralbrowser

Permanent profile and default browser

The Flatpak launcher uses ~/.var/app/io.github.martin08abm.umbralbrowser/data/umbral/profile. Test profiles under /tmp are temporary. Keep a backup before migrating; do not copy a profile while the browser is open.

In KDE, select Umbral in System Settings → Default Applications → Web Browser. In Flatpak, onboarding cannot set it directly and points you to desktop settings.

Update manually

Browser updates are manual. On Linux, before replacing the Flatpak, close Umbral and back up its profile. Build or obtain a newer trusted bundle. Reinstalling preserves data if you do not use --delete-data. Check the build identifier in about:support; the package name may still say 1.0.0. On Windows, manually replace the ZIP files with those from a newer build.

flatpak uninstall --user io.github.martin08abm.umbralbrowser
flatpak install --user dist/umbral-linux-x86_64.flatpak

Uninstall without deleting data

This removes the application and preserves the profile. Adding --delete-data also erases its private app data: that is a destructive option, not an update step.

flatpak uninstall --user io.github.martin08abm.umbralbrowser