{{Header}}
{{Title|title=
{{project_name_long}} Live ISO (via USB) and Installation
}}
{{#seo:
|description={{project_name_short}} Installation Guide. This guide will help you download the ISO image, create your bootable media, and install Kicksecure on your computer.
|image=/w/images/thumb/d/d6/Computer-laptop.svg/300px-Computer-laptop.svg.png
}}
[[File:Computer-laptop.svg|thumb|180px]]
{{VirtualBox_CSS}} __NOTOC__ {{Intro|
This is a guide for easily '''creating a {{project_name_short}} Live USB stick, then booting {{project_name_short}} from this stick and then optionally installing {{project_name_short}} to your harddrive from this stick'''. To prepare, you need a USB stick. In the process, you will download our .iso
file.
}}
{{mbox
|addToClass=cs-yellow-light margin-v-25
|icon=fa-solid fa-exclamation cs-red
|text=
'''Disclaimers'''
{{mbox
|icon=fa-solid fa-exclamation cs-yellow
|text='''No stable version available for users yet''': There is no ETA (estimated time of arrival) yet. Users who want a stable version should [[Download|choose another option]] instead.
}}
{{mbox
|icon=fa-solid fa-reply cs-yellow
|text='''Live Mode''': Looking for {{project_name_short}} Live Mode? It's already available, see [[Live_Mode]].
}}
{{Disclaimer}}
}}
{{mbox
|addToClass=margin-v-25
|icon=fa-solid fa-info cs-blue
|text=
'''Table of contents'''
# [[#Download.2C_Create_Live_USB|Download, Create Live USB]] : In this chapter you will learn how to create a {{project_name_short}} Live USB stick. This chapter contains the steps {{Icon|style=round|fa-solid fa-1 cs-green}} {{Icon|style=round|fa-solid fa-2 cs-green}} {{Icon|style=round|fa-solid fa-3 cs-green}} {{Icon|style=round|fa-solid fa-4 cs-green}}
# [[#Install_Kicksecure_.28Optional.29|Install Kicksecure (Optional)]] : In this chapter you learn how to install {{project_name_short}} to your harddrive from the Live USB stick you created. This chapter contains the steps {{Icon|style=round|fa-solid fa-5 cs-green}} {{Icon|style=round|fa-solid fa-6 cs-green}} {{Icon|style=round|fa-solid fa-7 cs-green}}
# [[#Finalize_and_further_documentation|Finalize and further documentation]] : This chapter gives you further information. It contains the steps {{Icon|style=round|fa-solid fa-8 cs-green}} {{Icon|style=round|fa-solid fa-9 cs-green}}
# [[#Footnotes|Footnotes]] and [[#License|License]] can be found at the bottom
}}
= Download, Create Live USB =
Please follow these steps to install {{project_name_short}} Xfce.
{{javascript-looks-better-with-javascript}} {{Anchor|Landing}}
{{mbox
|addToClass=margin-v-25
|text=
== Download {{project_name_short}} Xfce ISO ==
{{mbox
|icon=fa-solid fa-exclamation cs-red
|addToClass=cs-yellow-light
|text=
* '''Testers only:''' There is no stable version available currently. Please proceed with caution.
* '''Note:''' Save your download to your usual Downloads folder, not to the USB stick.
}}
Restore Disk Image
. ====
'''Figure:''' ''GNOME Disk Restore Select''
[[File:GNOME-disk-restore-select.png|600px|frameless|alt=GNOME Disk Restore Select|GNOME Disk Restore Select]]
==== {{Icon|fa-solid fa-5 cs-green}} Click on the field of ''Image to restore'' ====
Click on the field of ''Image to restore'' and navigate with your file manager to select {{project_name_short}} ISO. After you are finished, click on Start Restoring
.
'''Figure:''' ''GNOME Disk Restore ISO''
[[File:GNOME-Disk-restore-iso.png|600px|frameless|alt=GNOME Disk Restore ISO|GNOME Disk Restore ISO]]
==== {{Icon|fa-solid fa-6 cs-green}} Make sure you have selected the right device and click on Restore
. ====
'''Figure:''' ''GNOME Disk Restore ISO Confirm''
[[File:Disk-restore-iso-confirm.png|600px|frameless|alt=GNOME Disk Restore ISO Confirm|GNOME Disk Restore ISO Confirm]]
==== {{Icon|fa-solid fa-7 cs-green}} Wait for the flashing of the ISO to finish. ====
'''Figure:''' ''GNOME Disk Restoring''
[[File:GNOME-Disk-Restoring.png|600px|frameless|alt=GNOME Disk Restoring|GNOME Disk Restoring]]
==== {{Icon|fa-solid fa-8 cs-green}} After flashing is completed, the ''Contents'' field will indicate ''ISO 9660''. ====
'''Figure:''' ''GNOME Disk Finish''
[[File:GNOME-Disk-finish.png|600px|frameless|alt=GNOME Disk Finish|GNOME Disk Finish]]
==== {{Icon|fa-solid fa-9 cs-green}} Done. ====
The process of flashing {{project_name_short}} ISO to USB has been completed.
}}
{{Tab
|title= === Terminal ===
|image=[[File:Utilities-terminal.png|50px]]
|content=
Note: The following steps works on Unix terminals with GNU utilities.
==== {{Icon|fa-solid fa-1 cs-green}} Find the name of your drive, substitute ====
Find the name of your drive, substitute every reference of My_own_drive
to your own drive ID.'''
{{CodeSelect|code=
ls -l /dev/disk/by-id/usb-*
}}
==== {{Icon|fa-solid fa-2 cs-green}} Check with lsblk
====
Check with lsblk
to make sure that My_own_drive
is '''not''' mounted (blank field under ''MOUNTPOINTS'').'''
Note: Replace My_own_drive
with the actual name of your device.
{{CodeSelect|code=
lsblk /dev/disk/by-id/usb-My_own_drive
}}
==== {{Icon|fa-solid fa-3 cs-green}} Copy the {{project_name_short}} ISO to My_own_drive
. ====
Note: The path to {{project_name_short}}-Xfce-{{VersionNew}}.iso
needs to be adjusted in case the user did not download the ISO image to the home folder.
{{CodeSelect|code=
sudo cp {{project_name_short}}-Xfce-{{VersionNew}}.iso /dev/disk/by-id/usb-My_own_drive
}}
pv
and tee
.
** Advantage: Progress meter.
** Disadvantage: Not installed by default on many distributions.
** {{CodeSelect|inline=true|code=
pv {{project_name_short}}-Xfce-{{VersionNew}}.iso {{!}} sudo tee /dev/disk/by-id/usb-My_own_drive >/dev/null
}}
* Using cat
and tee
.
** Advantage: Tools always available.
** Disadvantage: No progress meter.
** {{CodeSelect|inline=true|code=
cat {{project_name_short}}-Xfce-{{VersionNew}}.iso {{!}} sudo tee /dev/disk/by-id/usb-My_own_drive >/dev/null
}}
* Using dd
.
** Advantage: Progress meter.
** Disadvantage: More complicated syntax.
** {{CodeSelect|inline=true|code=
sudo dd if={{project_name_short}}-Xfce-{{VersionNew}}.iso of=/dev/disk/by-id/usb-My_own_drive bs=4M conv=fsync oflag=direct status=progress
}}
dd
for example).
}}
}}
{{Tab
|title= === Qubes ===
|image=[[File:Qubes-logo-icon.png|50px]]
|content=
'''Flashing the {{project_name_short}} ISO while using Qubes'''
{{Collapsible
|addToClass=cs-yellow-light
|smallTitle=true
|title={{Icon|fa-solid fa-exclamation cs-red}} Prerequisite knowledge
|content=
* Context: Currently using a Qubes VM such as for example a Qubes VM running Debian or another Linux? Attempting to flash the {{project_name_short}} ISO to USB? If you can answer both questions with yes, this wiki tab is for you.
* What this is not: This is not about a {{project_name_short}} Template. For that, go to [[Qubes|{{project_name_short}} for Qubes]].
* Prior USB storage device usage in Qubes: Having used USB storage devices in Qubes before. This is important because there are many issues with Qubes and USB devices. General issues with be [[unspecific|unspecific to {{project_name_short}}]] and should not be mixed when attempting something slightly more complex such as flashing an operating system to USB.
* Appropriate choice: Properly using a Qubes App Qube to flash a USB drive when following this documentation should have a very low disk of data loss. The usual advice about the importance of backups and a tested backup restoration process of course always applies unrelated to this documentation.
* Choice of method: Choose either Command Line Image Writer or a Graphical Image Writer. Not both.
* Connect only 1 USB device to the App Qube: To guard against data loss, it is recommended and much simpler to only connect 1 USB device to the App Qube to be used for flashing the {{project_name_short}} ISO.
* Usage of examples in documentation: The following documentation uses the files which represent physical devices /dev/xvdi
(or /dev/sda
) as example devices. These instructions were tested inside a Debian based App Qube on Qubes R4.2. In theory, in later Qubes versions these files might represent other devices. If only 1 USB devices is connected to the App Qube and if only using that App Qube for flashing, the risk of data loss should on other USB devices should be very low. And of course, data in other App Qubes would be secure as usual thanks to Qubes compartmentalization.
}}
'''{{Icon|fa-solid fa-1 cs-green}} Make sure you have the required prerequisite knowledge mentioned above. Do not proceed without it!'''
'''{{Icon|fa-solid fa-2 cs-green}} Choose one option below for either graphical image writer or command-line image writer to get the matching instructions.'''
{{Tab
|type=controller
|content=
{{Tab|
|title= === Graphical Image Writer in Qubes ===
|content=
'''{{Icon|fa-solid fa-3 cs-green}} dom0
→ Qubes Device Manger in systray → Use USB Device: → assign the hard drive to the VM.'''
Note: Data (Block) Devices
cannot be used.
'''{{Icon|fa-solid fa-4 cs-green}} It is possible to use [https://apps.kde.org/isoimagewriter/ KDE ISO Image Writer], which is available as [https://download.kde.org/stable/isoimagewriter/1.0.0/KDE%20ISO%20Image%20Writer-1.0.0-x86_64.AppImage AppImage] and from [https://flathub.org/apps/details/org.kde.isoimagewriter Flathub].'''
'''{{Icon|fa-solid fa-5 cs-green}} Done.'''
The process of flashing {{project_name_short}} ISO to USB has been completed.
}}
{{Tab|
|title= === Command-Line Image Writer in Qubes ===
|content=
'''{{Icon|fa-solid fa-3 cs-green}} Device method choice.'''
{{mbox
|text=
Choose either using block device or using USB device. Two options. Choose one.
{{Tab
|type=controller
|content=
{{Tab|
|title= ==== Using Block device ====
|content=
'''{{Icon|fa-solid fa-4 cs-green}} dom0
→ Qubes Device Manger in systray → under "Data (Block) Devices" → select the USB device (for example sda
→ assign the hard drive to the VM.'''
'''{{Icon|fa-solid fa-5 cs-green}} Inside the VM, flash the image to USB:''' {{CodeSelect|code=
sudo cp {{project_name_short}}-Xfce-{{VersionNew}}.iso /dev/xvdi
}}
}}
{{Tab|
|title= ==== Using USB Device ====
|content=
'''{{Icon|fa-solid fa-4 cs-green}} dom0
→ Qubes Device Manger in systray → Use USB Device: → assign the hard drive to the VM.'''
'''{{Icon|fa-solid fa-5 cs-green}} Inside the VM, flash the image to USB:''' {{CodeSelect|code=
sudo cp {{project_name_short}}-Xfce-{{VersionNew}}.iso /dev/sda
}}
}}
}}
}}
'''{{Icon|fa-solid fa-6 cs-green}} Inside the VM, write buffers to the disk:''' {{CodeSelect|code=
sudo sync
}}
'''{{Icon|fa-solid fa-7 cs-green}} In dom0, use the Qubes Device Manger to remove the USB from the VM.'''
'''{{Icon|fa-solid fa-8 cs-green}} Done.'''
The process of flashing Kicksecure ISO to USB has been completed.
}}
}}
}}
}}
}}
}}
{{mbox
|addToClass=margin-v-25
|text=
== Boot the ISO ==
'''{{Icon|fa-solid fa-1 cs-green}} Discover the Boot Menu key based on your machine's motherboard. Search on the internet if necessary for your specific motherboard model.'''
{{{!}} class="wikitable" style="background-color: #fff;text-align: left"
! '''Vendor'''
! '''Key'''
{{!}}-
{{!}} Acer
{{!}} F12, F9, F2, Esc
{{!}}-
{{!}} Apple
{{!}} Option
{{!}}-
{{!}} Asus
{{!}} Esc
{{!}}-
{{!}} Clevo
{{!}} F7
{{!}}-
{{!}} Dell
{{!}} F12
{{!}}-
{{!}} Fujitsu
{{!}} F12, Esc
{{!}}-
{{!}} HP
{{!}} F9
{{!}}-
{{!}} Huawei
{{!}} F12
{{!}}-
{{!}} Intel
{{!}} F10
{{!}}-
{{!}} Lenovo
{{!}} F12, Novo
{{!}}-
{{!}} MSI
{{!}} F11
{{!}}-
{{!}} Samsung
{{!}} Esc, F12, F2
{{!}}-
{{!}} Sony
{{!}} F11, Esc, F10
{{!}}-
{{!}} Toshiba
{{!}} F12
{{!}}-
{{!}} Others
{{!}} F12, Esc
{{!}}}
'''{{Icon|fa-solid fa-2 cs-green}} Power off your host computer.'''
'''{{Icon|fa-solid fa-3 cs-green}} Connect the drive you just flashed to your computer.'''
'''{{Icon|fa-solid fa-4 cs-green}} Power on your computer and press several times the first possible Boot Menu key identified in step 1.'''
'''{{Icon|fa-solid fa-5 cs-green}} If the computer starts on another operating system or returns an error message, shut down the computer again and repeat step 4 for all the possible Boot Menu keys identified in step 1. If a Boot Menu with a list of devices appears, select your USB stick and press Enter.'''
'''{{Icon|fa-solid fa-6 cs-green}} If the computer starts on {{project_name_short}} ISO, the GRUB Boot Loader will appear giving boot options. After some seconds, it will automatically boot the ISO.'''
'''Figure:''' ''Kicksecure ISO GRUB''
[[File:Kicksecure-ISO-GRUB.png|600px|frameless|alt=Kicksecure ISO GRUB|Kicksecure ISO GRUB]]
'''{{Icon|fa-solid fa-7 cs-green}} After boot, you will encounter the following desktop.'''
'''Figure:''' ''Kicksecure ISO Live Setup Wizard''
(Todo: Screenshot slightly outdated.)
[[File:Kicksecure-ISO-Live-Setup-Wizard.png|600px|frameless|alt=Kicksecure ISO Live Setup Wizard|Kicksecure ISO Live Setup Wizard]]
'''{{Icon|fa-solid fa-8 cs-green}} You can experiment with the [[Live_Mode|Live ISO]] without saving data persistently, before committing to install {{project_name_short}} to hard drive (optional).'''
}}
= Install {{project_name_short}} (Optional) =
Learn how to install {{project_name_short}} from the newly created Live USB stick, if you so choose.
{{mbox
|addToClass=margin-v-25
|text=
== Start installation ==
'''{{Icon|fa-solid fa-1 cs-green}} Click on the desktop icon ''Install to Hard drive''.'''
'''Figure:''' ''ISO Install to hard drive icon''
[[File:ISO-install-icon.png|600px|frameless|alt=ISO Install to hard drive icon|ISO Install to hard drive icon]]
'''{{Icon|fa-solid fa-2 cs-green}} Be welcomed by the Calamares Installer and select your language.'''
'''Figure:''' ''ISO Calamares Welcome''
[[File:ISO-calamares-welcome.png|600px|frameless|alt=ISO Calamares Welcome|ISO Calamares Welcome]]
'''{{Icon|fa-solid fa-3 cs-green}} Choose how to partition your system.'''
Choose "Erase Disk" to replace the operating system on your internal hard drive. Usually no other changes required by most users.
{{mbox
| image = [[File:Preferences_system.png|40px|alt=Warning!]]
| text = [[File:Ambox_warning_pn.svg.png|40px|alt=Warning]] '''Warnings:'''
* Target device deletion: This procedure will '''overwrite all data on the selected device, be careful!'''
* Target device selection: Only installation to an internal hard drive or another USB drive is possible.
** The same in other words:
*** It is impossible to write to the same USB drive that was used to boot. Installing {{project_name_short}} on USB is possible, see [[USB Installation]].
*** The boot device and the installation target device must be two physically different devices.
}}
If you do not agree with summary, press Back
and choose the partition scheme again.
'''Figure:''' ''ISO Calamares Partition''
[[File:ISO-calamares-partition.png|600px|frameless|alt=ISO Calamares Partition|ISO Calamares Partition]]
'''{{Icon|fa-solid fa-4 cs-green}} Notice for users of full disk encryption.'''
If you would like to use [[Full_Disk_Encryption|full disk encryption (FDE)]], it can be done in the Partition tab. Choose "Encrypt system".
/boot
but with English US QWERTY keyboard. This can be confusing. The user might type the password in their local keyboard layout while GRUB at boot time will be interpreting the password using English US QWERTY keyboard layout.
* en_US QWERTY keyboards: This is a non-issue for users using US keyboards.
* other keyboards: This issue exists.
Which workarounds are available to users? Choose one.
* '''A)''' Use a separate English US QWERTY keyboard for password entry;
* '''B)''' Avoid characters which are different on your local vs the English US QWERTY keyboard layout;
* '''C)''' Use a different installation method. Using [[Debian|Distribution morphing]] it will be possible to avoid [[Full_Disk_Encryption#encrypted_boot|encrypted /boot
]] by using Debian's old installer ([https://www.debian.org/releases/stable/i386/ch01s04.en.html "d-i
"] [https://wiki.debian.org/DebianInstaller/GUI Debian's installer GUI (GTK based)]);
* '''D)''' Not using full disk encryption. Not recommended.
Less realistic workarounds, for developers only and tickets, see footnote.
Less realistic workarounds:
* '''F)''' Workaround the bug by patching Kicksecure Calamares installer to use unencrypted /boot;
* '''G)''' Fix the GRUB bug.
Tickets:
* installer, Calamares bug report [https://github.com/calamares/calamares/issues/1203 Encryption does not work well with non-QWERTY keyboards]
* Debian feature request: [https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=686817 grub-pc: Add option to change keyboard layout]
* bootloader, GNU grub feature request: [https://savannah.gnu.org/bugs/index.php?65113 Add All Keyboard Layouts and Selector to Early GRUB Core Image (grubx64.efi)]
Install
to proceed with the installation.'''
'''Figure:''' ''ISO Calamares Summary''
[[File:ISO-calamares-summary.png|600px|frameless|alt=ISO Calamares Summary|ISO Calamares Summary]]
'''{{Icon|fa-solid fa-6 cs-green}} Installation has begun. Soon you will be able to enjoy your new {{project_name_short}} operating system.'''
'''Figure:''' ''ISO Calamares Install''
[[File:ISO-calamares-install.png|600px|frameless|alt=ISO Calamares Install|ISO Calamares Install]]
'''{{Icon|fa-solid fa-7 cs-green}} Installation has been completed. Please uncheck the restart option to avoid booting to the same device again. Click Done
when finished.'''
'''Figure:''' ''ISO Calamares Uncheck Restart''
{{#if: {{{addToClass|}}} |
[[File:Calamares-uncheck-restart.png|600px|frameless|alt=Calamares Uncheck Restart|Calamares Uncheck Restart]]
'''{{Icon|fa-solid fa-8 cs-green}} On the Xfce Panel, click on the ''Applications'' icon and launch the ''Logout'' application.'''
'''Figure:''' ''Xfce Launch Logout''
[[File:launch-logout.png|600px|frameless|alt=Launch Logout|Launch Logout]]
'''{{Icon|fa-solid fa-9 cs-green}} On the ''Logout'' application, click on Shut Down
.'''
'''Figure:''' ''Xfce Shutdown''
[[File:logout.png|600px|frameless|alt=Logout|Logout]]
}}
}}
{{mbox
|addToClass=margin-v-25
|text=
== Remove installation media ==
Please remove the USB flash drive that was used to install {{project_name_short}}.
}}
{{mbox
|addToClass=margin-v-25
|text=
== Boot installed {{project_name_short}} ==
'''{{Icon|fa-solid fa-1 cs-green}} Power on the computer. If you boot from the correct device (where {{project_name_short}} Xfce is installed), you will face the following bootloader screen. Please wait some seconds for the operating system to start. If you didn't boot with the correct device, repeat the [[ISO#Boot_the_ISO|step 3]] to select the correct drive.'''
'''Figure:''' ''Installed Kicksecure GRUB''
[[File:Kicksecure-GRUB.png|600px|frameless|alt=Kicksecure GRUB|Kicksecure GRUB]]
'''{{Icon|fa-solid fa-2 cs-green}} The {{project_name_short}} Setup Wizard will pop up, follow its instructions.'''
'''Figure:''' ''Installed Kicksecure Desktop Setup Wizard''
(Todo: Screenshot slightly outdated.)
[[File:Iso-installed-setup-wizard.png|600px|frameless|alt=ISO Installed Setup Wizard|ISO Installed Setup Wizard]]
}}
= Finalize and further documentation =
The process is done. Please read further and support the Future of {{project_name_short}} with a [[Donate|Donation]]
{{mbox
|addToClass=margin-v-25
|text=
== Done ==
The process of installing {{project_name_short}} Xfce has been completed, enjoy!
Continue your journey by reading [[Documentation#First_{{non_q_project_name_short}}_Steps|First {{non_q_project_name_short}} Steps]] documentation.
}}
{{mbox
|addToClass=margin-v-25
|text=
== Support the Future of {{project_name_short}} ==
{{donation_appeal_download}}
}}
= Footnotes =