{{project_name_long}} Live ISO (via USB) and Installation

{{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 <code>.iso</code> file.
}}

{{mbox|text=
{{Icon|fa-solid fa-question cs-yellow}} Looking for '''other download options'''? Check out [[Download]].
}}
= 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)'''

<gallery widths=170 class="thumb-gallery-style justify-left">
File:Iso-page-step1-download.svg|Download ISO
File:Iso-page-step3-flash-usb.svg|Flash ISO to USB
File:Iso-page-step4-boot-usb.svg|Boot from USB
File:Iso-page-step4-boot-done.svg|Live {{project_name_short}} running
</gallery>
}}

{{mbox
|text=
{{IconSet|h4|2}} '''[[#Install_{{project_name_short}}_.28Optional.29|Install {{project_name_short}} (Optional)]] : In this chapter you learn how to install {{project_name_short}} to your harddrive from the Live USB stick you created. (Steps 4-7)'''

<gallery widths=170 class="thumb-gallery-style justify-left">
File:Iso-page-step5-start-install.svg|Click install in Live {{project_name_short}}
File:Iso-page-step6-7-remove-boot-hdd.svg|Remove USB, boot from HD
File:Iso-page-step7-hdd-boot-done.svg|Local {{project_name_short}} running
</gallery>
}}

{{mbox
|text=
{{IconSet|h4|3}} '''[[#Finalize_and_further_documentation|Finalize and further documentation]] : This chapter gives you further information and helps with troubleshooting. (Steps 8,9,10)'''
}}

= Download, Create Live USB =

'''Please follow these steps to install {{project_name_short}} Xfce.'''

{{Icon|fa-solid fa-exclamation cs-yellow}} Note: This is for "normal" computers that most people are using (Intel64 / AMD64 processor). For other architectures, see [[Architecture_Support|Architecture Support]].

{{javascript-looks-better-with-javascript}} {{Anchor|Landing}}
{{mbox
|addToClass=margin-v-25
|text=
== {{IconSet|h1|1}} Download {{project_name_short}} Xfce ISO ==

[[File:Iso-page-step1-download.svg|link=|250px]]


{{mbox
|icon=fa-solid fa-exclamation cs-red
|addToClass=cs-yellow-light
|text='''Note:''' Save your download to your usual Downloads folder, not to the USB stick.
}}

{{Tab
|type=controller
|addToClass=margin-top-10
|content=
{{Tab
|active=true
|title= === stable Xfce ===
|image=[[File:Rg1024_brick_tile.png]]
|content=
{{DownloadTableUnified
|project_name={{project_name_short}}
|os_keyword=iso
|os_name=ISO
|version_type=stable
|flavor=Xfce
|after_slash=iso
|extension=Intel_AMD64.iso
|version={{VersionNew}}
}}
}} 

{{Tab
|title= === testers Xfce ===
|image=[[File:Cornues.png]]
|content=
{{DownloadTableUnified
|project_name={{project_name_short}}
|os_keyword=iso
|os_name=ISO
|version_type=testers
|flavor=Xfce
|after_slash=iso
|extension=Intel_AMD64.iso
|version={{VersionTesters}}
}}
}} 
}} 
}} 

{{mbox
|addToClass=margin-v-25
|text=
== {{IconSet|h1|2}} Write the ISO to USB ==

[[File:Iso-page-step3-flash-usb.svg|link=|250px]]

* In this process you will use a software tool to create a {{project_name_short}} Live USB by writing our ISO onto this USB stick.
* This procedure is similar for ALL Linux distribution which provide a Live USB stick for installation. The procedure is therefore [[unspecific|unspecific to {{project_name_short}}]].

{{Collapsible
|addToClass=toccolours cs-yellow-light
|title={{IconSet|false|!}} '''Warning: Please be aware of this information before creating a Live USB the first time.'''
|smallTitle=true
|content=
* '''Target device deletion''': Be aware that the process will completely erase everything on the USB drive you use - absolutely all data. It's important to understand that once you start this process, there's no going back, and anything on that USB drive will be permanently lost.
* '''Backup''': Before you start, please make sure you save copies of anything important on your computer. This includes all documents, photos, movies, and save games, ensuring they are securely backed up. That way, if something goes wrong, you won't lose anything valuable. It's not just the USB drive you should worry about; you need to back up your entire computer, just in case. This is because if you accidentally select the wrong device - like your computer's internal hard drive instead of the USB drive - all the data on your computer could be erased. See also [[Backup]]. Skip this step only at your own risk.
* '''Restoration test''': After making your backup, check to see if you can actually open and use those files. This is to make sure your backup really works. It's important to verify that the backup is successful and that your important files are safe and accessible, should you need to restore them later.
* '''Unplug Non-Essential devices and drives''': To minimize risk, unplug any non-essential external drives or devices that could be misidentified as a target for flashing.
}}

{{mbox
|addToClass=cs-gray-light
|text=
* '''Choose your host operating system''': Now below, please select the operating system you are currently using and that you intend to use to create the {{project_name_short}} Live USB stick.
* After your selection, only the individual instructions for the selected operating system will be shown.

<div class="vspacer-10"></div>

{{Tab
|type=controller
|content=

{{Tab|
|title= === Windows/Mac ===
|image=[[File:Logo-windows-500x500.png|50px]] [[File:Logo-apple-500x500.png|50px]]
|content=
==== {{IconSet|h2|1}} Download [https://etcher.balena.io/#download-etcher balenaEtcher] ====
<div class="toccolours cs-white mw-collapsible mw-collapsed" data-expandtext="Learn More" data-collapsetext="Show Less">
<u>Optional</u>: A checksum can be found in each release for verification.
<div class="mw-collapsible-content">
For very experience users only. All other users skip this step.

[https://github.com/balena-io/etcher/releases Etcher Github]

See also: [[Download Security]]
</div>
</div>

<u>Note:</u> Save your download to your usual Downloads folder, not to the USB stick.

==== {{IconSet|h2|2}} Open the balenaEtcher download ====

At the security warning, confirm that you want to open balenaEtcher.

==== {{IconSet|h2|3}} Choose either method "Flash from file" <u>or</u> "Flash from URL" ====

{{mbox
|addToClass=cs-white
|text=
{{Tab
|type=controller
|content=
{{Tab
|title= === Flash from file ===
|image=[[File:Folder-file-icon.svg.png|25px]]
|active=true
|content=
'''{{IconSet|h3|1}} Select "Flash from file" then navigate to the downloaded image path.'''

[[File:Etcher1.png|470px]]

'''{{IconSet|h3|2}} Then press "Select Target" to choose the flash drive you want to use.'''

[[File:Etcher2.png|470px]]

'''{{IconSet|h3|3}} Tick your flash drive, then press "Select".'''

[[File:Etcher2-1.png|470px]]

'''{{IconSet|h3|4}} Press "Flash".'''

[[File:Etcher3.png|470px]]

'''{{IconSet|h3|5}} Done.'''

The process of flashing {{project_name_short}} ISO to USB has been completed.
}} 

{{Tab
|title= === Flash from URL ===
|image=[[File:Secbrowser.png|25px]]
|content=

<div class="toccolours cs-gray-light mw-collapsible mw-collapsed" data-expandtext="Learn More" data-collapsetext="Show Less">
<u>Optional</u>: Digital signature verification.
<div class="mw-collapsible-content">
Unsupported if using "Flash from URL".
</div>
</div>

'''{{IconSet|h3|1}} Select "Flash from URL".'''

[[File:Etcher1-1.png|470px]]

'''{{IconSet|h3|2}} Get the {{project_name_short}} image URL.'''

Scroll up to the download link. Right click on it.

[[File:Etcher1-2.png|470px]]

'''{{IconSet|h3|3}} Paste the URL to "Use Image URL" then press "OK".'''

[[File:Etcher1-3.png|470px]]

'''{{IconSet|h3|4}} Press "Flash".'''

[[File:Etcher3.png|470px]]

'''{{IconSet|h3|5}} Done.'''

The process of flashing {{project_name_short}} ISO to USB has been completed.
}} 
}} 
}} 
}} 

{{Tab
|title= === Linux ===
|image=[[File:Logo-linux-500x500.png|50px]]
|content=

==== {{IconSet|h2|1}} Install ''GNOME Disks''. ====

The utility is pre-installed in ''GNOME'' desktop environment. Otherwise it can be installed on most if not all Linux distributions.

{{iso_writer_installation_linux}}

==== {{IconSet|h2|2}} Launch ''GNOME Disks''. ====

{{mbox
|addToClass=cs-gray-light
|text=
{{IconSet|h3|A}} Using the start menu.

'''Figure:''' ''GNOME Disks Xfce Launch''

[[File:GNOME-Disks-Xfce-Launch.png|600px|frameless|alt=GNOME Disks Xfce Launch|GNOME Disks Xfce Launch]]

{{IconSet|h3|B}} Alternatively, you could also start GNOME disks from the command line.

{{CodeSelect|code=
gnome-disks
}}
}}

==== {{IconSet|h2|3}} Select your device present on the right tab. ====

'''Figure:''' ''GNOME Disk Select''

[[File:Gnome-disk-select.png.png|600px|frameless|alt=GNOME Disk Select|GNOME Disk Select]]

==== {{IconSet|h2|4}} On the three dots menu on the top right side, click on <code>Restore Disk Image</code>. ====

'''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 <code>Start Restoring</code>.

'''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 <code>Restore</code>. ====

'''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=<u>Note:</u> 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 <code>My_own_drive</code> to your own drive ID.'''

{{CodeSelect|code=
ls -l /dev/disk/by-id/usb-*
}}

==== {{IconSet|h2|2}} Check with <code>lsblk</code> ====

Check with <code>lsblk</code> to make sure that <code>My_own_drive</code> is '''not''' mounted (blank field under ''MOUNTPOINTS'').'''

<u>Note:</u> Replace <code>My_own_drive</code> 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 <code>My_own_drive</code>. ====

<u>Note:</u> The path to <code>{{project_name_short}}-Xfce-{{VersionNew}}.Intel_AMD64.iso</code> 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
}}
<div class="toccolours cs-gray-light mw-collapsible mw-collapsed" data-expandtext="Learn More" data-collapsetext="Show Less">
Click on 'Learn More' on the right side for other command-line methods.
<div class="mw-collapsible-content">
* Using <code>pv</code> and <code>tee</code>.
** 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 <code>cat</code> and <code>tee</code>.
** 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 <code>dd</code>.
** 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
}}

</div>
</div>

==== {{IconSet|h2|4}} Ensure buffers are fully written to the device before removing it. ====

{{CodeSelect|inline=true|code=
sudo sync
}}

==== {{IconSet|h2|5}} Done. ====

The process of flashing {{project_name_short}} ISO to USB has been completed.

}}

{{Tab
|title= === BSD ===
|image=[[File:Signify_Logo.svg|50px]]
|content=
{{mbox|
|icon=fa-solid fa-exclamation cs-blue
|addToClass=cs-yellow-light
|text=
If you are using BSD all the steps from the tab 'Terminal' (left of this tab) apply to you. Click [[#Terminal]] and study the instructions. '''Then consult your BSD operating system documentation on how to use these listed tools in BSD'''. Especially check how to flash an ISO, as the utilities commands may differ (<code>dd</code> 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=
* <u>Context:</u> 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.
* <u>What this is not:</u> This is not about a {{project_name_short}} Template. For that, go to [[Qubes|{{project_name_short}} for Qubes]].
* <u>Prior USB storage device usage in Qubes:</u> 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.
* <u>Appropriate choice:</u> 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.
* <u>Choice of method:</u> Choose either Command Line Image Writer <u>or</u> a Graphical Image Writer. Not both.
* <u>Connect only 1 USB device to the App Qube:</u> 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.
* <u>Usage of examples in documentation:</u> The following documentation uses the files which represent physical devices <code>/dev/xvdi</code> (or <code>/dev/sda</code>) 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}} <code>dom0</code> → Qubes Device Manger in systray → <u>Use USB Device:</u> → assign the hard drive to the VM.'''

<u>Note:</u> <code>Data (Block) Devices</code> <u>cannot</u> 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}} <code>dom0</code> → Qubes Device Manger in systray → under "Data (Block) Devices" → select the USB device (for example <code>sda</code> → 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}} <code>dom0</code> → Qubes Device Manger in systray → <u>Use USB Device:</u> → 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|3}} 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 <u>Boot Menu Key</u> : 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 <u>if in the next step (step 5) NO key is working</u> 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 <code>Erase Disk</code> 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=
* <u>Target device deletion:</u> This procedure will <u>'''overwrite all data on the selected device, be careful!'''</u>
* <u>Target device selection:</u> 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 <code>Back</code> and choose the partition scheme again.

'''Figure:''' ''ISO Calamares Partition''

[[File:ISO-calamares-partition.png|600px|frameless|alt=ISO Calamares Partition|ISO Calamares Partition]]

<code>Encrypt system</code> means using [[Full Disk Encryption|{{fde}}]].

'''{{IconSet|h2|4}} Confirm the partition by looking at a summary of actions that will be done to your drive. If you agree, press <code>Install</code> 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 <code>Done</code> 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 <code>Shut Down</code>.'''

'''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}} [[Full Disk Encryption|{{fde}}]] Pre-Boot Authentication Screen.

'''Figure:''' ''initramfs (dracut) Based Encryption Password [[Full_Disk_Encryption#Pre-Boot_Authentication|Pre-Boot Authentication]] Prompt - Example (cropped)''

[[File:Dracutpass-cropped.png|frameless|1200px|alt={{project_name_short}} GRUB|initramfs (dracut) Based Encryption Password Prompt - Example (cropped)]]

This is a [[Grub#initramfs_.28initramfs-tools_or_dracut.29_Based_Encryption_Password_Prompt|initramfs (dracut) Based Encryption Password Prompt]].

'''{{IconSet|h2|3}} 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 =
<references />

= License =
{{License_Amnesia|{{FULLPAGENAME}}}}

{{Footer}}
[[Category:Documentation]]