Skip to content
Athena OS

Aegis Installer TUI

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. This file has the following structure:

{
    "partition": {
        "device": "/dev/sda",
        "mode": "Auto",
        "encrypt_check": false,
        "efi": true,
        "swap": false,
        "swap_size": "",
        "partitions": []
    },
    "bootloader": {
        "type": "grub-efi",
        "location": "/boot"
    },
    "locale": {
        "locale": [
            "en_US.UTF-8 UTF-8"
        ],
        "virtkeymap": "en",
        "x11keymap": "us",
        "timezone": "Europe/Zurich"
    },
    "networking": {
        "hostname": "athenaos",
        "ipv6": false
    },
    "users": [
        {
            "name": "athena",
            "password": "$6$99BF/Qo0T3QNKTVr$8PNNp8EkjhM./XeFUeW1hIBrbh9ev74HI73idhhQMUWVyGTzba85zl7tzhkDL27OUVJYzybnFNgNwYNaf3LiJ0",
            "hasroot": true,
            "shell": "fish"
        }
    ],
    "rootpass": "$6$bFPyjuoCYjXVLoHy$c9oEzhS6gDj/icOsb2kPh43ML7V6FMeybNB6ZGu7deFKbhzTrOhr2loW/8WrrMbO1l1DTfe1E2SA46zt7tJKI1",
    "desktop": "gnome",
    "theme": "temple",
    "displaymanager": "gdm",
    "browser": "firefox",
    "terminal": "kitty",
    "extra_packages": [


    ],
    "flatpak": true,
    "zramd": true,
    "kernel": "linux-lts",
    "params": {
        "cores": "",
        "jobs": ""
    }
}

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:

Terminal window
aegis-tui

Aegis TUI

Choose your favourite base system between Athena Arch or Athena Nix Aegis TUI

Timezone

Select the timezone System Timezone

Console Keymap

Select the console keymap Console Keymap

X11 Keymap

Select the X11 keymap X11 Keymap

Locale

Select the locale System Locale

Users

Set your user account User Account

Set your password User Password User Verify Password

Choose if the inserted password should be the same for the root account too User Same Root Password

If choose No, set a password for the root account Root Password Root Verify Password

Shell

Select your favourite shell System Shell

Hostname

Set the hostname System Hostname

Partitioning

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
Installing as dual boot
Virtual Machine scenario

Desktop

Select your favourite theme System Desktop

Theme

Select your favourite theme System Theme

Login Manager

Select your favourite display manager for login System Login

Browser

Select your favourite browser Browser

Terminal

Select your favourite terminal System Terminal

Miscellaneous Settings

Select your favourite settings by using Space key button and confirm by Enter System Settings

Review the Summary and run the installation. Install Summary

Select the install parameters for the installation process (Athena Nix only) Install Set Cores Install Set Jobs

Finally, if you are ready to install, proceed Install Confirm

During the installation, installation logs are saved in /tmp/aegis.log. In case the installation gets some issues, run:

Terminal window
install-logs

and

Terminal window
config-logs

to get the links to https://termbin.com where the logs are temporary saved. Communicate these links to Athena OS Team for troubleshooting.

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

Installation Finished

Before rebooting, if you installed Athena OS in dual boot with Windows, as explained in the related section, restore Microsoft bootloader inside the boot partition (i.e., /dev/nvme0n1p1):

Terminal window
sudo mount /dev/nvme0n1p1 /mnt
sudo cp -rf ~/Microsoft /mnt/EFI/
sudo umount /mnt

Once you reboot, and you land on the installed system, open the terminal and run:

Terminal window
sudo os-prober
sudo grub-mkconfig -o /boot/grub/grub.cfg

In this manner, Windows entry should be added in GRUB.

For Athena Nix installation, once reboot and land on the installed system, initialize Nix Channels by opening the terminal and running:

Terminal window
sudo nix-channel --add https://nixos.org/channels/nixos-unstable nixos
sudo nix-channel --add https://github.com/nix-community/home-manager/archive/master.tar.gz home-manager
sudo nix-channel --update