{{Header}} {{hide_all_banners}}
{{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 {{project_name_short}} 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.
}}
= Table of contents =
{{mbox
|text=
{{IconSet|h4|1}} '''[[#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. (Steps 1-5)'''
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]]
==== {{IconSet|h2|5}} 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]]
==== {{IconSet|h2|6}} 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]]
==== {{IconSet|h2|7}} 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]]
==== {{IconSet|h2|8}} 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]]
==== {{IconSet|h2|9}} 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.
==== {{IconSet|h2|1}} 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-*
}}
==== {{IconSet|h2|2}} 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
}}
==== {{IconSet|h2|3}} Copy the {{project_name_short}} ISO to My_own_drive
. ====
Note: The path to {{project_name_short}}-Xfce-{{VersionNew}}.Intel_AMD64.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}}.Intel_AMD64.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}}.Intel_AMD64.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}}.Intel_AMD64.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}}.Intel_AMD64.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={{IconSet|false|!}} 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.
}}
'''{{IconSet|h2|1}} Make sure you have the required prerequisite knowledge mentioned above. Do not proceed without it!'''
'''{{IconSet|h2|2}} 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=
'''{{IconSet|h2|3}} dom0
→ Qubes Device Manger in systray → Use USB Device: → assign the hard drive to the VM.'''
Note: Data (Block) Devices
cannot be used.
'''{{IconSet|h2|4}} 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].'''
'''{{IconSet|h2|5}} Done.'''
The process of flashing {{project_name_short}} ISO to USB has been completed.
}}
{{Tab|
|title= === Command-Line Image Writer in Qubes ===
|content=
'''{{IconSet|h2|3}} 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=
'''{{IconSet|h2|4}} dom0
→ Qubes Device Manger in systray → under "Data (Block) Devices" → select the USB device (for example sda
→ assign the hard drive to the VM.'''
'''{{IconSet|h2|5}} Inside the VM, flash the image to USB:''' {{CodeSelect|code=
sudo cp {{project_name_short}}-Xfce-{{VersionNew}}.Intel_AMD64.iso /dev/xvdi
}}
}}
{{Tab|
|title= ==== Using USB Device ====
|content=
'''{{IconSet|h2|4}} dom0
→ Qubes Device Manger in systray → Use USB Device: → assign the hard drive to the VM.'''
'''{{IconSet|h2|5}} Inside the VM, flash the image to USB:''' {{CodeSelect|code=
sudo cp {{project_name_short}}-Xfce-{{VersionNew}}.Intel_AMD64.iso /dev/sda
}}
}}
}}
}}
'''{{IconSet|h2|6}} Inside the VM, write buffers to the disk:''' {{CodeSelect|inline=true|code=
sudo sync
}}
'''{{IconSet|h2|7}} In dom0, use the Qubes Device Manger to remove the USB from the VM.'''
'''{{IconSet|h2|8}} Done.'''
The process of flashing {{project_name_short}} ISO to USB has been completed.
}}
}}
}}
}}
}}
}}
{{mbox
|addToClass=margin-v-25
|text=
== {{IconSet|h1|4}} Boot the ISO ==
[[File:Iso-page-step4-boot-usb.svg|link=|250px]]
'''This short video that explains the whole booting process''' in simple terms. Below that are the detailed instructions for the booting process.
{{mbox
|addToClass=display-inline-block
|text=
[[File:ISO-boot-menu-explainer.mp4|500px]]
}}
'''{{IconSet|h2|1}} Power off your host computer.'''
'''{{IconSet|h2|2}} Connect the USB drive you just flashed to your computer.'''
'''{{IconSet|h2|3}} Research Boot Menu Key : Find out your computer's motherboard's specific KEY (on the keyboard) that opens the Boot Menu'''.
Search the table below (click "Expand" to enlarge") or search on the internet to find out the boot menu key for your specific motherboard model. Write down the key "candidates" (because you cannot be sure before trying) for your specific model. Usually only ONE key opens the Boot Menu, but due to different vendors and models, there is no uniform key which opens the boot menu for all computers. Usually one of the following keys will be the one.
{{IconSet|keyboard|F2}} {{IconSet|keyboard|F7}} {{IconSet|keyboard|F9}} {{IconSet|keyboard|F10}} {{IconSet|keyboard|F11}} {{IconSet|keyboard|F12}} {{IconSet|keyboard|ESC}} {{IconSet|keyboard|OPTION}} {{IconSet|keyboard|NOVO}}
{{Collapsible
|title=RESEARCH BOOT MENU KEY table (Click Expand)
|content=
{{{!}} class="wikitable"
! '''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
{{!}}}
}}
'''{{IconSet|h2|4}} CONDITIONAL STEP : Activate your Boot Menu in the BIOS.'''
This step depends on your operating system. '''For most users this step is not necessary and can be skipped'''. But if in the next step (step 5) NO key is working for you to start the Boot Menu you need to do this step.
{{IconSet|h3|1}} Web-search and find a good tutorial with this term {{CodeSelect|code=[my computer / motherboard name] how to enable Boot Menu}}
{{IconSet|h3|2}} Follow the instructions in the tutorial until you're certain that you've enabled the Boot Menu on your system
{{IconSet|h3|3}} Now you're ready to proceed with the next step
'''{{IconSet|h2|5}} Power on your computer. As soon as it starts booting press you Boot Menu Key several times (twice per second should be enough)'''
This should open the Boot Menu after pressing the key for a couple of seconds. The figure below shows an example of a Boot Menu. The look of different boot menus can vary strongly between vendors. But in principle (1) it says "Boot Menu" and (2) gives you different options to choose from.
'''Figure:''' Boot menu example
[[File:Boot-menu-example.jpg|400px]]
'''{{IconSet|h2|6}} Try out all the Boot Menu key "candidates"'''
{{IconSet|h3|1}} If the computer starts on another operating system (meaning NOT {{project_name_short}}) or returns an error message, shut down the computer again and repeat step 5 for all the possible Boot Menu key "candidates" identified in step 3.
{{IconSet|h3|2}} If you have no luck with any of the Boot Menu key "candidates" or if you enter a menu called "BIOS" then you need to go back to step 4.
{{IconSet|h3|3}} If a Boot Menu with a list of devices appears, that's correct. Now select your USB stick (in the example image "Removable Devices", but the name can vary) and press Enter.
'''{{IconSet|h2|7}} GRUB Boot Loader Step'''
If the computer starts on {{project_name_short}} ISO, the GRUB Boot Loader will appear giving boot options. You can read the instructions or just sit back. After some seconds, it will automatically boot the ISO.
'''Figure:''' ''{{project_name_short}} ISO GRUB''
[[File:{{project_name_short}}-ISO-GRUB.png|600px|frameless|alt={{project_name_short}} ISO GRUB|{{project_name_short}} ISO GRUB]]
'''{{IconSet|h2|8}} After boot, you will encounter the {{project_name_short}} desktop.'''
'''Figure:''' ''{{project_name_short}} Desktop''
[[File:Kicksecure-Desktop.png|600px|frameless|alt={{project_name_short}} Desktop|{{project_name_short}} Desktop]]
'''{{IconSet|h2|9}} DONE.'''
You can experiment with the [[Live_Mode|Live ISO]] without saving data persistently, before committing to install {{project_name_short}} to hard drive (optional).
}}
{{mbox
|text=
{{Icon|border=thick|shadow=true|style=rounded|fa-solid cs-green fa-2x|text=WELL DONE! 😃}}
Up to this point you have '''downloaded''' the {{project_name_short}} ISO, '''flashed the ISO''' to a USB stick and '''booted your computer''' from this USB stick! You can work with the live system or go on and permanently install {{project_name_short}}.
}}
= 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=
== {{IconSet|h1|5}} Start installation ==
[[File:Iso-page-step5-start-install.svg|link=|250px]]
'''{{IconSet|h2|1}} 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]]
'''{{IconSet|h2|2}} 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]]
'''{{IconSet|h2|3}} 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.
{{Collapsible
|addToClass=toccolours cs-yellow-light
|title={{IconSet|false|!}} '''Warning: Please be aware of this information before installing the first time.'''
|smallTitle=true
|content=
* 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]]
'''{{IconSet|h2|4}} Confirm the partition by looking at a summary of actions that will be done to your drive. If you agree, press Install
to proceed with the installation.'''
'''Figure:''' ''ISO Calamares Summary''
[[File:ISO-calamares-summary.png|600px|frameless|alt=ISO Calamares Summary|ISO Calamares Summary]]
'''{{IconSet|h2|5}} 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]]
'''{{IconSet|h2|6}} 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''
[[File:Calamares-uncheck-restart.png|600px|frameless|alt=Calamares Uncheck Restart|Calamares Uncheck Restart]]
'''{{IconSet|h2|7}} 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]]
'''{{IconSet|h2|8}} 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=
== {{IconSet|h1|6}} Remove installation media ==
[[File:Iso-page-step6-7-remove-boot-hdd.svg|link=|250px]]
Please remove the USB flash drive that was used to install {{project_name_short}}.
}}
{{mbox
|addToClass=margin-v-25
|text=
== {{IconSet|h1|7}} Boot installed {{project_name_short}} ==
'''{{IconSet|h2|1}} 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 4]] to select the correct drive.'''
'''Figure:''' ''Installed {{project_name_short}} GRUB''
[[File:{{project_name_short}}-GRUB.png|600px|frameless|alt={{project_name_short}} GRUB|{{project_name_short}} GRUB]]
'''{{IconSet|h2|2}} The {{project_name_short}} desktop will appear.
'''Figure:''' ''{{project_name_short}} Desktop''
[[File:Kicksecure-Desktop.png|600px|frameless|alt={{project_name_short}} Desktop|{{project_name_short}} Desktop]]
}}
{{mbox
|text=
{{Icon|border=thick|shadow=true|style=rounded|fa-solid cs-green fa-2x|text=CONGRATULATIONS! 😃}}
'''You have successfully installed {{project_name_short}} to your hard drive and booted it'''. You can now permanently work with your {{project_name_short}} installation!
}}
= 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=
== {{IconSet|h1|8}} Done ==
[[File:Iso-page-step7-hdd-boot-done.svg|link=|250px]]
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=
== {{IconSet|h1|9}} Support the Future of {{project_name_short}} ==
{{donation_appeal_download}}
}}
{{mbox
|addToClass=margin-v-25
|text=
== {{IconSet|h1|10}} Troubleshooting ==
If you're having trouble anywhere in this process, visit [[Troubleshooting#ISO|Troubleshooting#ISO]] for troubleshooting help
}}
= Footnotes =