# Download and install AxOS

## What you will need

**A USB key** Or any external drive (minimum **4gb**)

**Risk acceptance** ; I don't have a lot of reviews, so don't blame me if something is not working, just tell me instead, so i can fix it for the next releases.

***

## Getting Started

First thing you have to do is to flash your external drive with the latest AxOS ISO. You can download it from [here](https://github.com/AxOS-project/AxOS/releases/latest).

When you have the .iso file, flash it:

**On Windows:** Use [Rufus](https://rufus.ie) or [Etcher](https://etcher.balena.io/) to do it easily

**On Linux:** You can use Etcher as well, or you can do it by command line:

```bash
$ sudo dd bs=4M if=path/to/axos.iso of=/dev/sdX status=progress oflag=sync
```

* Make sure you replace **path/to/axos.iso** with the AxOS ISO path and **sdX** with your USB device. (you can find it with the command `fdisk -l`)

If these steps are clear, you're ready

***

## Boot AxOS

Once your bootable key is ready, you can boot it in your computer. Here are the steps to do it:

* **Shutdown your computer**
* **Plug your flashed drive**
* **Enter the bios:** the method depends on your computer.
* **Select your flashed drive for boot**

Done, you booted AxOS !

***

## Install AxOS

Once you have booted, you enter into the live environment. You can try AxOS, and when you want to install it, you can use the **AxOS installer.** To find it, you can type "**Install AxOS**" in the app launcher.&#x20;

Follow the steps of the installer for the installation.

***

## Installer steps

The installer has multiple pages. Here are some details:

### Select keyboard layout

In this step, you will be able to chose your keyboard layout. The default one us en\_US normal, but you can find yours by pressing the "**Search**" button.&#x20;

After you chose your layout, you can try it in the "Test your keyboard" field.

Attention: The modifications will be applied AFTER the installation! Your keyboard will be in US layout when you type your username/password/hostname during the installation process.

### Create User

Be careful, the keyboard layout will be en\_US by default.

### Select desktop

You have 3 choices:

* Plasma: Using the KDE plasma desktop environment. This one aims for stability, functionalities and ease of use.
* Calla: Calla is a tiling desktop environment based on AwesomeWM. You could encounter bugs, but it is usable. It aims for performances and minimalism, so you may have some basic Linux knowledge before installing this desktop.
* Hyprland: Unstable and Unusable in Virtual Machines. Install at your own risks (but still cool tho)

### Select Kernel

The kernel is the core of the operating system. You have two options here:

* Linux: The basic, stable and most used kernel.
* Linux Zen: This kernel is aimed for better reactivity and responsiveness, but can be less stable than the default Linux kernel



Once you did every steps, the install process will begin. A fresh AxOS will be installed on your disk with the latest packages. **This process may take some time, depending on the strength of your internet connection.**

{% hint style="warning" %}
If an error occurs, the installation process will be stopped, but the installer will say that the installation is completed.
{% endhint %}

***

#### Congratulations, you have installed AxOS !
