{{Header}}
{{title|title=
Browser Choice - Browser Selection Installer Dialog
}}
{{#seo:
|description=Browser Choice is a simple wizard that helps you install and remove web browsers on {{project_name_short}}. It exists so you can pick the browser you prefer, without the system forcing a single default choice.
|image=Default-list-of-browsers-3.png
}}
{{browser_mininav}}
{{intro|
<code>browser-choice</code> helps you install and remove web browsers using a simple graphical wizard.
}}
= Introduction =
Browser Choice is a user-friendly installer dialog for choosing a web browser on {{project_name_short}}. It provides a convenient way to install or remove browsers without forcing a single default choice for all users.

For background and technical details (design, plugin system, inclusion criteria), see [[Dev/browser-choice|Browser Choice (<u>dev</u>elopers)]]. For broader context on default browser considerations, see [[Dev/Default_Browser|Default Browser (dev)]].

'''Figure:''' ''Browser Choice''

[[File:Default-list-of-browsers-3.png|600px]]

= Browser Installation =
{{IntroLike|
HowTo: Install a browser using browser-choice.
}}

{{IconSet|h1|1}} Boot into <code>Persistent Mode | SYSMAINT Session</code>

In the Kicksecure GRUB boot menu, select <code>PERSISTENT Mode | SYSMAINT Session | system maintenance tasks</code> and press <code>Enter</code>.

'''Figure:''' ''Kicksecure GRUB Boot Menu''

[[File:Boot-into-Sysmaint-session-1.svg|600px]]

{{IconSet|h1|2}} Click <code>Install a Browser</code>

In the System Maintenance Panel, click <code>Install a Browser</code>.

'''Figure:''' ''System Maintenance Panel''

[[File:Choose-Install-a-Browser-2.png|600px]]

{{IconSet|h1|3}} Select a browser from the list

In the Browser Choice wizard, select the browser you want to install.

'''Figure:''' ''Browser Choice Wizard, Step 1/4: Select Application''

[[File:Default-list-of-browsers-3.png|600px]]

{{IconSet|h1|4}} Select Firefox (as an example)

Select <code>Firefox</code>, then click <code>Continue</code>.

'''Figure:''' ''Browser Choice Wizard, Step 1/4: Firefox Selected''

[[File:Choose-Firefox-4.png|600px]]

{{IconSet|h1|5}} Source of installation

Choose the installation source, ensure <code>Install</code> is selected, then click <code>Continue</code>.

'''Figure:''' ''Browser Choice Wizard, Step 2/4: Choose Installation Options''

[[File:Install-Firefox-From-Debian-5.png|600px]]

Choices for installation:

* Either from the Debian repository, which is going to be the [https://www.firefox.com/en-US/browsers/enterprise/ ESR version]. 
* [https://www.mozilla.org/en-US/firefox/all/desktop-release/ Rapid Release] version from the official Firefox repository.
* The [https://flathub.org/en/apps/org.mozilla.firefox Rapid Release] version of Firefox, verified and uploaded to the Flathub repository. 

Select: <code>Install</code>

<code>Don't update software database before installation</code>: Means do not run <code>apt update</code> before installing the package.

{{IconSet|h1|6}} Installation command review

Review the command that will be executed, then click <code>Continue</code> to proceed.

'''Figure:''' ''Browser Choice Confirmation Dialog: Command Preview''

[[File:How-the-command-to-install-it-6.png|600px]]

{{IconSet|h1|7}} Wait for the installation to complete

Wait until the operation finishes, then click <code>Continue</code>.

'''Figure:''' ''Browser Choice Wizard, Step 3/4: Applying Software Changes''

[[File:Wait-until-the-operation-finish-7.png|600px]]

{{IconSet|h1|8}} Installation finished

Click <code>Done</code>, then restart or reboot the system.

'''Figure:''' ''Browser Choice Wizard, Step 4/4: Software Changes Complete''

[[File:Installation-completed-8.png|600px]]

{{IconSet|h1|9}} Boot into <code>USER Session</code>

In the Kicksecure GRUB boot menu, select <code>PERSISTENT Mode | USER Session | daily activities</code> and press <code>Enter</code>.

'''Figure:''' ''Kicksecure GRUB Boot Menu''

[[File:boot-into-user-session-9.svg|600px]]

{{IconSet|h1|10}} Start the browser.

Open the applications menu, select the <code>Internet</code> category, then click <code>Firefox ESR</code>.

'''Figure:''' ''Kicksecure Application Menu: Firefox ESR''

[[File:Find-Firefox-10.png|600px]]

{{IconSet|h1|11}} Done

Confirm Firefox starts successfully and loads the Kicksecure Welcome Page.

'''Figure:''' ''Firefox ESR: Kicksecure Welcome Page''

[[File:Run-Firefox-11.png|800px]]

= Plugins =
Features a plugin based design and multiple installation types.

[[Dev/browser-choice#criteria_for_inclusion_into_browser_choice|Criteria for inclusion into browser choice]]

= Forum Discussion =
[https://forums.kicksecure.com/t/browser-choice/1025 Browser Choice forum discussion]

<references />
[[Category:Design]]
{{Footer}}