Documentation

Start here

Umbral is a Zen fork based on Firefox. Linux with Flatpak is the primary platform; Windows is offered as an experimental ZIP with manual updates. This is not presented as a stable general release.

Make the homepage yours

Add your own shortcuts, edit their names and addresses, reorder or remove them. Sites are not added automatically. The cards below show ETP records and uBlock Origin status.

Search engines and SearXNG

Choose your engine in Settings → Search. For SearXNG, enter a trusted instance URL and confirm adding it. Typing the URL does not contact it. Adding it does not switch engines until you select it; remote suggestions from that instance are not enabled.

Local AI, step by step

Enable it in onboarding or Settings → Local AI. Its button opens the panel even before a model is configured. It is optional and off by default.

Run a local server compatible with the OpenAI API, configure its base URL and exact model name, then save. For example, http://127.0.0.1:1234/v1 if your server listens there. Umbral appends /chat/completions; do not include that path in the base URL. The API key is optional depending on your server.

A request is made only when you send a message. You can cancel it, hide or resize the panel, and clear the conversation. Umbral does not download or run the model.

Containers, extensions and passwords

New tabs inherit the active container; without a usable tab, the last used in that workspace is used. Select another from the dropdown. Containers separate session contexts; they do not provide anonymity.

uBO keeps its original popup beside the address bar. Settings let you stop password-saving offers without disabling autofill or deleting existing passwords. Some external password-manager integrations with host apps need specific Flatpak support.