Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
en:manual:reference_installation [2023/12/03 15:20]
throgh
en:manual:reference_installation [2024/03/26 23:08]
throgh
Line 229: Line 229:
  
 <note> <note>
-If you do not see output similar to this, then your wireless driver has not been loaded. Please see [[https://wiki.parabola.nu/Wireless_Setup|Wireless Setup]] for more detailed information.+If you do not see output similar to this, then your wireless driver has not been loaded.
 </note> </note>
  
Line 245: Line 245:
 </code> </code>
  
-Then, your wireless chipset could need a <color #B90B0B/#FFDDDD>non-free firmware</color> to function. **This is not supported on Hyperbola**. Please see [[https://wiki.parabola.nu/Wireless_Setup|Wireless Setup]] if you are unsure if this is the true for your particular chipset.+Then, your wireless chipset could need a <color #B90B0B/#FFDDDD>non-free firmware</color> to function. **This is not supported on Hyperbola**.
 </note> </note>
  
Line 357: Line 357:
 ===== Installation ===== ===== Installation =====
 ==== Partition disks ==== ==== Partition disks ====
 +
 +<note important>
 +These instructions assume that you are using MBR (Master Boot Record) as the partitioning scheme for your installation disk. Installation on a GPT-based disk is slightly different than the process described here.
 +</note>
 +
 Once your computer has successfully booted into the Live USB device, type the following into you terminal: Once your computer has successfully booted into the Live USB device, type the following into you terminal:
  
Line 390: Line 395:
 <code bash> <code bash>
 # swapon /dev/sda1 # swapon /dev/sda1
-</code> 
- 
-=== Mount the root partition === 
-<code bash> 
-# mount /dev/sda2 /mnt 
 </code> </code>
  
Line 420: Line 420:
  
 We now must mount the root partition on <color #0B71B9/#DDF1FF>/mnt</color>. You should also create directories for and mount any other partitions (<color #0B71B9/#DDF1FF>/mnt/boot</color>, <color #0B71B9/#DDF1FF>/mnt/home</color>, ...) and mount your swap-partition if you want them to be detected by <color #620BB9/#EEDDFF>genfstab</color>. We now must mount the root partition on <color #0B71B9/#DDF1FF>/mnt</color>. You should also create directories for and mount any other partitions (<color #0B71B9/#DDF1FF>/mnt/boot</color>, <color #0B71B9/#DDF1FF>/mnt/home</color>, ...) and mount your swap-partition if you want them to be detected by <color #620BB9/#EEDDFF>genfstab</color>.
 +=== Mount the root partition ===
 +
 +<code bash>
 +# mount /dev/sda2 /mnt
 +</code>
  
 ==== Verification of system-date ==== ==== Verification of system-date ====
Line 484: Line 489:
 # arch-chroot /mnt # arch-chroot /mnt
 </code> </code>
- 
-  * Write your hostname to <color #0B71B9/#DDF1FF>/etc/hostname</color> 
  
 === Hostname === === Hostname ===
Line 508: Line 511:
 </code> </code>
  
-<code bash> 
-# echo myhostname > /etc/hostname 
-</code> 
  
-  * Symlink <color #0B71B9/#DDF1FF>/etc/localtime</color> to <color #0B71B9/#DDF1FF>/usr/share/zoneinfo/Zone/SubZone</color>. Replace <color #620BB9/#EEDDFF>Zone</color> and <color #620BB9/#EEDDFF>Subzone</color> to your liking. For example:+=== Locale ===
  
-<code bash> +Type the following to set locale preferences in <color #0B71B9/#DDF1FF>/etc/locale.conf</color>
-# ln -s /usr/share/zoneinfo/Europe/Athens /etc/localtime +
-</code> +
- +
-  * Set [[en:manual:beginner_installation#locale|locale]] preferences in <color #0B71B9/#DDF1FF>/etc/locale.conf</color> +
- +
-=== Locale === +
-Type:+
  
 <code bash> <code bash>
Line 528: Line 521:
  
 Now choose your locale from what language you’re using. All locales are commented out (preceded by #) by default. Uncomment (remove the #) for your choice of locale. For US English, it should look like this: Now choose your locale from what language you’re using. All locales are commented out (preceded by #) by default. Uncomment (remove the #) for your choice of locale. For US English, it should look like this:
- 
-<code bash> 
-# nano /etc/locale.gen 
-</code> 
  
 <code> <code>
Line 547: Line 536:
 </code> </code>
  
-Then create the <color #0B71B9/#DDF1FF>/etc/locale.conf</color>+Then check the file <color #0B71B9/#DDF1FF>/etc/locale.conf</color>. If not existing you can create it like following up:
  
 <code bash> <code bash>
Line 553: Line 542:
 </code> </code>
  
-Then export your chosen locale+Then export your chosen locale, just in case for your current session
  
 <code bash> <code bash>
Line 559: Line 548:
 </code> </code>
  
- +Add console keymap and font preferences in <color #0B71B9/#DDF1FF>/etc/conf.d/keymaps</color>
-  * Add console keymap and font preferences in <color #0B71B9/#DDF1FF>/etc/conf.d/keymaps</color>+
  
 === Keymap === === Keymap ===
Line 576: Line 564:
  
 <note>This only applies for CLI, is you are using X11, this won't affect your graphical environment.</note> <note>This only applies for CLI, is you are using X11, this won't affect your graphical environment.</note>
- 
-  * Uncomment the selected locale in <color #0B71B9/#DDF1FF>/etc/locale.gen</color> and generate it with <color #620BB9/#EEDDFF>locale-gen</color> 
  
 === Time zone === === Time zone ===
Line 635: Line 621:
 </note> </note>
  
-<code bash> +To configure the bootloader, you have to install it and generate the file <color #0B71B9/#DDF1FF>grub.cfg</color>:
-# grub-mkconfig -o /boot/grub/grub.cfg +
-</code> +
- +
-  * To configure the bootloader, you have to install it and generate the file <color #0B71B9/#DDF1FF>grub.cfg</color>:+
  
 <code bash> <code bash>
Line 645: Line 627:
 </code> </code>
  
-  * For BIOS and EFI:+=== Syslinux ===
  
-<code bash> +[[https://en.wikipedia.org/wiki/SYSLINUX|Syslinux]] is a collection of boot loaders capable of booting from drives, CDs, and over the network via PXE. Install the **[[https://www.hyperbola.info/packages/?q=syslinux|syslinux]]**-package with the following command:
-# pacstrap /mnt grub +
-</code>+
  
-  * Install GRUB after chrooting (refer to the [[en:manual:reference_installation#Configure the system]] section). 
- 
-See [[https://wiki.parabola.nu/GRUB2|GRUB]] for further details. 
- 
-=== Syslinux === 
 <code bash>  <code bash> 
 # pacstrap /mnt syslinux # pacstrap /mnt syslinux
 </code> </code>
  
-See [[https://wiki.parabola.nu/Syslinux|Syslinux]] for further details.+=== Create RAM-disk  ===
  
-  * Configure <color #0B71B9/#DDF1FF>/etc/mkinitcpio.conf</color> as needed (see man-page for mkinitcpio) and create an initial RAM disk with:+Configure <color #0B71B9/#DDF1FF>/etc/mkinitcpio.conf</color> as needed (//see man-page for mkinitcpio//) and create an initial RAM disk with:
    
 <code bash> <code bash>
Line 670: Line 645:
 <note>linux-libre-lts is **our default kernel** since we are a long-term support distro.</note> <note>linux-libre-lts is **our default kernel** since we are a long-term support distro.</note>
  
-  * If you want to install GRUB for the (U)EFI mode, you will need to make sure that:+If you want to install GRUB for the (U)EFI mode, you will need to make sure that:
     * The computer booted in (U)EFI mode (if <color #0B71B9/#DDF1FF>/sys/firmware/efi</color> exist, then it booted in (U)EFI mode)     * The computer booted in (U)EFI mode (if <color #0B71B9/#DDF1FF>/sys/firmware/efi</color> exist, then it booted in (U)EFI mode)
     * The efivars module is loaded. (<color #620BB9/#EEDDFF>modprobe efivars</color> will load it)     * The efivars module is loaded. (<color #620BB9/#EEDDFF>modprobe efivars</color> will load it)
- 
-=== Bootloader on external drive === 
- 
-<note tip> 
-If you are following the [[en:manual:encrypted_installation|libreboot encrypted installation]] instructions, be sure to save a copy of grub.cfg on a thumbdrive in case the one flashed to libreboot is incorrect. You can use the grub shell to boot from the extra copy. 
-</note> 
- 
--------------- 
- 
-  * Configure the network again for newly installed environment. 
- 
-=== Configure speech support (for blind and visually impaired users) === 
-If you are using  [[en:project:downloads#HyperTalking]] and need start speech support when you boot the system, you will need to do: 
- 
-  * Install [[https://www.hyperbola.info/packages/?q=espeakup|espeakup]] and [[https://www.hyperbola.info/packages/?q=alsa-utils|alsa-utils]]. 
-  * Enable the espeakup service by executing: 
- 
-<code bash> 
-# rc-update add espeakup default 
-</code> 
- 
-  * Save the state of the sound card, so that it will be retrieved on reboot: 
- 
-<code bash> 
-# alsactl store 
-</code> 
  
 === Unmount and reboot === === Unmount and reboot ===
Line 728: Line 677:
  
 ===== Post-installation ===== ===== Post-installation =====
-You will now have to create a user and get user privileges like doas. And of course, you will have to install your favourite Desktop Environment (DE)+You will now have to create a user and get user privileges like doas. And of course, you will have to install your favourite desktop.
  
 === Configure pacman === === Configure pacman ===
Line 736: Line 685:
 At this point you should update your system. At this point you should update your system.
  
-=== Add an user ===+<code bash> 
 +# pacman -Syu 
 +</code> 
 + 
 +=== Add an user and groups for privileges ===
 Finally, add a normal user. Finally, add a normal user.
  
 +<code bash>
 +# useradd -g users -m -s /bin/bash <username>
 +</code>
 +
 +You should consider the following groups to be used at start:
 +
 +<code bash>
 +# usermod -aG video <username>
 +</code>
 +
 +<code bash>
 +# usermod -aG audio <username>
 +</code>
 +
 +<code bash>
 +# usermod -aG sys <username>
 +</code>
 +
 +<code bash>
 +# usermod -aG storage <username>
 +</code>
 +
 +<code bash>
 +# usermod -aG optical <username>
 +</code>
 +
 +<code bash>
 +# usermod -aG power <username>
 +</code>
 +
 +<code bash>
 +# usermod -aG network <username>
 +</code>
 +
 +<code bash>
 +# usermod -aG input <username>
 +</code>
 +
 +If you want to access for updating:
 +
 +<code bash>
 +# usermod -aG wheel <username>
 +</code>
 +
 +Please remember also that to execute and access installed free, libre games you need another group-membership:
 +
 +<code bash>
 +# usermod -aG games <username>
 +</code>
 ==== Service management ==== ==== Service management ====
 Since Hyperbola is oriented on init-freedom, we suggest you read about [[https://wiki.hyperbola.info/doku.php?id=en:system:init_systems:openrc|OpenRC]] which is our main default init system. Since Hyperbola is oriented on init-freedom, we suggest you read about [[https://wiki.hyperbola.info/doku.php?id=en:system:init_systems:openrc|OpenRC]] which is our main default init system.