qusal/salt/browser
Ben Grande 383c840f2f
doc: lint markdown files
Only way to have a unified markdown syntax is to enforce the wanted
syntax by linting the files. Don't rely on the many markdown syntaxes,
be consistent.
2024-07-04 17:27:31 +02:00
..
files/repo fix: add Mullvad Browser 2024-06-28 12:24:29 +02: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
configure.sls fix: thunar requires xfce helpers to find terminal 2024-01-31 14:42:17 +01:00
configure.top fix: thunar requires xfce helpers to find terminal 2024-01-31 14:42:17 +01:00
create.sls fix: add Mullvad Browser 2024-06-28 12:24:29 +02:00
create.top refactor: initial commit 2023-11-13 14:33:28 +00:00
init.top fix: thunar requires xfce helpers to find terminal 2024-01-31 14:42:17 +01:00
install-chrome-repo.sls fix: remove extraneous package repository updates 2024-03-18 17:51:36 +01:00
install-chrome-repo.top fix: remove extraneous package repository updates 2024-03-18 17:51:36 +01:00
install-chrome.sls fix: add Mullvad Browser 2024-06-28 12:24:29 +02:00
install-chrome.top refactor: initial commit 2023-11-13 14:33:28 +00:00
install-chromium.sls fix: browser requires a state and not a package 2024-03-25 11:04:54 +01:00
install-chromium.top refactor: initial commit 2023-11-13 14:33:28 +00:00
install-common.sls feat: support browser installation on Fedora 2024-06-28 14:12:17 +02:00
install-common.top refactor: initial commit 2023-11-13 14:33:28 +00:00
install-firefox-esr.sls feat: add Firefox browser from Mozilla repository 2024-05-24 13:53:17 +02:00
install-firefox-esr.top feat: add Firefox browser from Mozilla repository 2024-05-24 13:53:17 +02:00
install-firefox-repo.sls feat: add Firefox browser from Mozilla repository 2024-05-24 13:53:17 +02:00
install-firefox-repo.top feat: add Firefox browser from Mozilla repository 2024-05-24 13:53:17 +02:00
install-firefox.sls fix: add Mullvad Browser 2024-06-28 12:24:29 +02:00
install-firefox.top feat: add Firefox browser from Mozilla repository 2024-05-24 13:53:17 +02:00
install-lynx.sls fix: remove extraneous package repository updates 2024-03-18 17:51:36 +01:00
install-lynx.top refactor: initial commit 2023-11-13 14:33:28 +00:00
install-mullvad-repo.sls fix: add Mullvad Browser 2024-06-28 12:24:29 +02:00
install-mullvad-repo.top fix: add Mullvad Browser 2024-06-28 12:24:29 +02:00
install-mullvad.sls fix: add Mullvad Browser 2024-06-28 12:24:29 +02:00
install-mullvad.top fix: add Mullvad Browser 2024-06-28 12:24:29 +02:00
install-w3m.sls fix: remove extraneous package repository updates 2024-03-18 17:51:36 +01: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 doc: lint markdown files 2024-07-04 17:27:31 +02:00
version fix: generate RPM Specs for Qubes Builder V2 2024-06-21 17:00:06 +02: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, Firefox-ESR, Mullvad-Browser, W3M or Lynx.

Installation

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

Choose your browser

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

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

Do not forget to sync the appmenus:

sudo 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