qusal/salt/browser
2023-12-26 19:53:59 +01:00
..
files/repo refactor: initial commit 2023-11-13 14:33:28 +00:00
appmenus.sls refactor: initial commit 2023-11-13 14:33:28 +00:00
appmenus.top refactor: initial commit 2023-11-13 14:33:28 +00:00
clone.sls refactor: initial commit 2023-11-13 14:33:28 +00:00
clone.top refactor: initial commit 2023-11-13 14:33:28 +00:00
create.sls refactor: initial commit 2023-11-13 14:33:28 +00:00
create.top refactor: initial commit 2023-11-13 14:33:28 +00:00
init.top refactor: initial commit 2023-11-13 14:33:28 +00:00
install-chrome.sls refactor: initial commit 2023-11-13 14:33:28 +00:00
install-chrome.top refactor: initial commit 2023-11-13 14:33:28 +00:00
install-chromium.sls refactor: initial commit 2023-11-13 14:33:28 +00:00
install-chromium.top refactor: initial commit 2023-11-13 14:33:28 +00:00
install-common.sls fix: browser cli install tool switches to fetcher 2023-12-26 19:53:59 +01:00
install-common.top refactor: initial commit 2023-11-13 14:33:28 +00:00
install-firefox.sls refactor: initial commit 2023-11-13 14:33:28 +00:00
install-firefox.top refactor: initial commit 2023-11-13 14:33:28 +00:00
install-lynx.sls refactor: initial commit 2023-11-13 14:33:28 +00:00
install-lynx.top refactor: initial commit 2023-11-13 14:33:28 +00:00
install-w3m.sls refactor: initial commit 2023-11-13 14:33:28 +00:00
install-w3m.top refactor: initial commit 2023-11-13 14:33:28 +00:00
install.sls refactor: initial commit 2023-11-13 14:33:28 +00:00
install.top refactor: initial commit 2023-11-13 14:33:28 +00:00
README.md refactor: initial commit 2023-11-13 14:33:28 +00:00

browser

Browser environment in Qubes OS.

Table of Contents

Description

Create environment for browsing. By default it creates a disposable template called "dvm-browser", so when clicking the icon/launcher, it opens a disposable qube. If you want to save your session, you can also clone the template and create app qubes.

Default browser to install is Chromium, but you can choose to install Chrome, Firefox-ESR, W3M or Lynx.

Installation

  • Top
qubesctl top.enable browser
qubesctl --targets=tpl-browser state.apply
qubesctl top.disable browser
qubesctl state.apply browser.appmenus
  • State
qubesctl state.apply browser.create
qubesctl --skip-dom0 --targets=tpl-browser state.apply browser.install
qubesctl state.apply browser.appmenus

Choose you browser

Instead of running the state browser.install, you can select which browser to install:

  • Chromium:
qubesctl --skip-dom0 --targets=tpl-browser state.apply browser.install-chromium
  • Chrome:
qubesctl --skip-dom0 --targets=tpl-browser state.apply browser.install-chrome
  • Firefox-ESR:
qubesctl --skip-dom0 --targets=tpl-browser state.apply browser.install-firefox
  • W3M:
qubesctl --skip-dom0 --targets=tpl-browser state.apply browser.install-w3m
  • Lynx:
qubesctl --skip-dom0 --targets=tpl-browser state.apply browser.install-lynx

Do not forget to sync the appmenus:

qubesctl state.apply browser.appmenus

Usage

Open a disposable qube simply by clicking on the desktop application dvm-browser (dvm): Browser.

If you want to use a permanent browser session, create an app qube based on tpl-browser.

If you are forwarding URLs from other qubes via qvm-open-in-(d)vm, you might want to set your preferred browser as the default browser in tpl-browser targeting the desired desktop file:

xdg-settings set default-web-browser firefox-esr.desktop