-
-
Notifications
You must be signed in to change notification settings - Fork 16
Installation
Welcome to the "Installation:" page! In this page we are going to explain the installation method of Ataraxia Linux for x86 and PowerPC-based PCs. Installation of Ataraxia Linux is very similar to Gentoo or Arch's installation method.
Ataraxia Linux team provides a PGP keys to sign images. If you want to verify image, you should use GnuPG. Don't forget to add our public key to check signature. Check integrity of iso file:
gpg --with-fingerprint ataraxialinux-[CPU architecture].iso.sig ataraxialinux-[CPU architecture].iso
Same with stage archive:
gpg --with-fingerprint ataraxialinux-[CPU architecture].tar.zst ataraxialinux-[CPU architecture].tar.zst
You should write Ataraxia's .iso image on your installation media. You can use your favorite method of doing this. After that, boot from your installation media.
Ataraxia Linux supports many keyboard layouts. By default it uses American keyboard layout. To list them you should use this command:
ls /usr/share/keymaps/**/*.map.gz | less
If you don't have keyboard with American layout you should set keyboard layout via this command:
loadkeys [your layout]
Ataraxia Linux supports EFI. To check for EFI use this command:
ls /sys/firmware/efi/efivars
Ataraxia Linux supports networking. To list available network devices use this command:
ifconfig -a | less
Ataraxia Linux uses systemd-networkd. To setup your dhcp connection add these strings to /etc/systemd/network/00-default.network:
[Match]
Name=[your interface]
[Network]
DHCP=ipv4
[DHCP]
UseDomains=true
And restart network configuration using this command:
chown systemd-network /etc/systemd/network/00-default.network
systemctl restart systemd-networkd
Ataraxia Linux uses systemd-networkd. To setup your static connection add these strings to /etc/systemd/network/00-default.network:
[Match]
Name=[your interface]
[Network]
Address=[your static address]/24
Gateway=[your gateway]
DNS=[your gateway]
Domains=[your domain name]
And restart network configuration using this command:
chown systemd-network /etc/systemd/network/00-default.network
systemctl restart systemd-networkd
Ataraxia Linux has 4 partition programs cfdisk, fdisk, gdisk and cgdisk. To list disks use this command:
fdisk -l
To start partitioning use this command:
cfdisk /dev/[your drive]
For people who use GPT partition table:
gdisk /dev/[your drive]
You should have at least 1 partition for /(root). But you can add partitions for /boot/, /home/ and swap.
If you decided to make a /boot/ partition use this command: (It's optional in general, but required for EFI users)
mkfs.ext2 /dev/[your boot partition]
For EFI users (REQUIRED):
WARNING: Don't forget to change the partition type to EFI System Partition (ESP)!
mkfs.fat -F32 /dev/[your boot partition]
Root partition should be format with ext4 filesystem. To do this use this command:
mkfs.ext4 /dev/[your root partition]
Home partition also should be formatted as ext4 filesystem. To do this use this command:
mkfs.ext4 /dev/[your home partition]
To make swap partition use this command:
mkswap /dev/[your swap partition]
In order you should to mount boot and root partitions. Mount partitions order:
1. Mount root partition
2. Creating directory for boot partition
3. Mount boot partition in boot directory
mount /dev/[root partition] /mnt
mkdir -p /mnt/boot
mount /dev/[boot partition] /mnt/boot
In order you should to mount home and swap partitions. Mount partitions order:
1. Creating directory for home partition
2. Mount home partition in home directory
3. Mount swap partition
mkdir -p /mnt/home
mount /dev/[home partition] /mnt/home
swapon /dev/[swap partition]
Ataraxia Linux has a pre-compiled rootfs. It's called stage archive.
To download the stage archive use this command:
cd /mnt
wget https://github.com/ataraxialinux/ataraxia/releases/download/[release]/ataraxialinux-[CPU architecture].tar.zst
To unpack stage archive use this command:
bsdtar -xvf ataraxialinux-[CPU architecture].tar.zst -C /mnt
To make Ataraxia Linux bootable you should generate /etc/fstab file:
genfstab -U /mnt >> /mnt/etc/fstab
mount --bind /proc /mnt/proc
mount --bind /sys /mnt/sys
mount --bind /dev /mnt/dev
mount --bind /run /mnt/run
chroot /mnt /bin/mksh
To set time zone:
ln -sf /usr/share/zoneinfo/Region/City /etc/localtime
and run hwclock to save the changes:
hwclock --systohc
Ataraxia Linux is a source-based Linux distribution. It uses neko to install ports. So we need get them:
reposync
Ataraxia uses binary blobs for some devices. They can add some functionality or even make your computer boot (people who use AMD/ATI Radeon and NVIDIA cards must install firmware to make your computer boot). Let's install firmware:
neko emerge linux-firmware
You may set up your hostname for your PC. It's quite easy by editing /etc/hostname, but difficult to come up with a name:
mypc
Follow steps that you have done before installation.
Edit /etc/neko/make.conf to enable use of all of your CPU cores for compilation.
Edit /etc/hosts
127.0.0.1 localhost.localdomain localhost
::1 localhost.localdomain localhost
127.0.1.1 *myhostname.localdomain* *myhostname*
This is an optional step:
passwd
useradd -m -G users,wheel,audio,video,input [your user]
and change the password:
passwd [your user]
The main bootloader is:
grub - bootloader for x86 and PowerPC. Supports EFI and BIOS (for x86).
Installing grub on your system:
neko emerge grub
and if you have EFI system:
neko emerge efibootmgr grub
To install grub on your device (for x86):
grub-install /dev/[device]
For EFI users:
grub-install --target=[x86_64 or i386]-efi --efi-directory=[EFI directory] --bootloader-id=GRUB
EFI users should use this (for PowerPC):
grub-install
And update configuration:
grub-mkconfig -o /boot/grub/grub.cfg
Now, exit chroot environment:
exit
Unmount everything:
umount /mnt/proc
umount /mnt/sys
umount /mnt/dev
umount /mnt/run
umount /mnt/boot
umount /mnt/home
umount /mnt
swapoff /dev/[swap partition]
and reboot:
reboot
You have installed Ataraxia Linux on your computer. Explore!