Skip to content

Commit

Permalink
Add aegis-tui
Browse files Browse the repository at this point in the history
  • Loading branch information
D3vil0p3r committed Jan 26, 2024
1 parent d50df0e commit 4d9ccd3
Showing 1 changed file with 145 additions and 0 deletions.
145 changes: 145 additions & 0 deletions src/content/docs/en/configuration/aegis-tui.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,145 @@
---
title: Aegis Installer TUI
description: How to install Athena OS by Aegis Installer TUI.
---
import ImageComponent from "@components/ImageComponent.astro";
import ThemedImage from '@components/ThemedImage.astro';

[Aegis TUI](https://github.com/Athena-OS/aegis-tui) is a terminal user interface frontend of **Aegis**, a tailored installer developed and optimized specifically for Athena OS.

To provide more accessible resources to the users, Aegis TUI provides a terminal interface to configure and install your systems according to your preferences.

Aegis will improve over time in order to detect automatically your hardware. It means that the installer is able to detect your environment (baremetal or virtualized), your CPU and your GPU. According to this information, all the needed drivers are automatically installed with no any actions by your side.

Aegis TUI can be run by running `aegis-tui` command and requires a working Internet connection.

Its purpose is to create a JSON configuration file containing all the user choices that is used to feed the Aegis backend, the real brain of the installer. The JSON configuration file will be saved as `/tmp/config.json`.

The installation logs will be saved to `/tmp/aegis.log` and copied to the installed system to `/var/log/aegis.log`.

### Installation

Open the terminal and run:
```
aegis-tui
```

#### Language
Availability: Easy and Advanced Installation.

1. Select the language
![System Language](@assets/images/calamares-welcome-offline.png)

#### Kernel
Availability: Advanced Installation.

2. Select your favourite kernel
![System Kernel](@assets/images/calamares-kernel.png)

:::note
The Easy Installation will implement **Linux Zen kernel** by default.
:::

#### Environment
Availability: Advanced Installation.

3. Select your favourite environment
![System Environment](@assets/images/calamares-environment.png)

:::note
The Easy Installation will install **GNOME environment** by default.
:::

#### Theme
Availability: Advanced Installation.

4. Select your favourite theme
![System Theme](@assets/images/calamares-theme.png)

:::note
The Easy Installation will install **Blue Eyes theme** by default.
:::

#### Login Manager
Availability: Advanced Installation.

5. Select your favourite display manager for login
![System Login](@assets/images/calamares-login.png)

:::note
The Easy Installation will install **GNOME Display Manager** by default.
:::

#### Shell
Availability: Advanced Installation.

6. Select your favourite shell
![System Shell](@assets/images/calamares-shell.png)

:::note
The Easy Installation will install **Bash** by default.
:::

#### Terminal
Availability: Advanced Installation.

7. Select your favourite terminal
![System Terminal](@assets/images/calamares-terminal.png)

:::note
The Easy Installation will install **GNOME Terminal** by default.
:::

#### Browser
Availability: Advanced Installation.

8. Select your favourite browser
![System Browser](@assets/images/calamares-browser.png)

:::note
The Easy Installation will install **Firefox ESR** by default.
:::

#### Utilities
Availability: Advanced Installation.

9. Select your favourite utilities
![System Utilities](@assets/images/calamares-utilities.png)

#### Location
Availability: Easy and Advanced Installation.

10. Select your location and timezone
![System Location and Timezone](@assets/images/calamares-location.png)

#### Keyboard
Availability: Easy and Advanced Installation.

11. Select your keyboard layout
![System Keyboard](@assets/images/calamares-keyboard.png)

#### Users
Availability: Easy and Advanced Installation.

12. Set your user account
![System Keyboard](@assets/images/calamares-users.png)

#### Partition
Availability: Easy and Advanced Installation.

13. Select your partition according to the installation type you are going to. Check the **Installation** chapter related to your setup and follow there the partition scheme to implement:
* [Installing as single boot](/en/installation/install-single-boot/#partitioning)
* [Installing as dual boot with Linux or Windows](/en/installation/install-dual-boot/#partitioning)

For virtual machine scenarios, just select **Erase disk**
![VM Erase Disk](@assets/images/calamares-vm-erase.png)

14. Review the **Summary** and run the installation.

During the installation, you can click on **Toggle log** button for reading in real time the installation logs. In case the installation gets some issues, Calamares provides to you a link to https://termbin.com where the logs are temporary saved in order to be accessed by the Athena OS team for troubleshooting.

15. If no errors have been raised during the installation phase, you are ready to use Athena OS!

![Installation Finished](@assets/images/calamares-finish.png)

<ImageComponent />

0 comments on commit 4d9ccd3

Please sign in to comment.