HyperWiki

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
en:manual:reference_installation [2023/12/04 18:23]
throgh [Post-installation] 		en:manual:reference_installation [2024/06/17 01:30] (current)
throgh [Blind and visually impaired users]
Line 3: Line 3:
  
 ==== Blind and visually impaired users ==== ==== Blind and visually impaired users ====
-[[en:project:downloads#Hyperbola]] includes **brltty**, for those who own braille displays.  The [[https://www.hyperbola.info/packages/?q=brltty|brltty]] package available on the CD was compiled with as few dependencies as possible. If you wish to use braille, you will need to supply the brltty parameter at the boot prompt.  Alternatively, you can start <color #620BB9/#EEDDFF>brltty</color> from the shell, after the system has booted.+[[en:project:downloads#Hyperbola]] includes **brltty**, for those who own braille displays.  The [[https://www.hyperbola.info/packages/?q=brltty|brltty]] package available was compiled with as few dependencies as possible. If you wish to use braille, you will need to supply the brltty parameter at the boot prompt.  Alternatively, you can start <color #620BB9/#EEDDFF>brltty</color> from the shell, after the system has booted.
  
-The brltty boot-time parameter consists of three comma-separated fields: **driver**, **device**, and **table**.  The first is the driver for your display, the second is the name of the device file, and the third is a relative path to a translation table.  You can use "<color #620BB9/#EEDDFF>auto</color>" to specify that the driver should be automatically detected.  I encourage you to read the <color #620BB9/#EEDDFF>brltty</color> documentation for a fuller explanation of the program. +The brltty boot-time parameter consists of three comma-separated fields: **driver**, **device**, and **table**.  The first is the driver for your display, the second is the name of the device file, and the third is a relative path to a translation table.  You can use "<color #620BB9/#EEDDFF>auto</color>" to specify that the driver should be automatically detected.  We encourage you to read the <color #620BB9/#EEDDFF>brltty</color> documentation for a fuller explanation of the program.
- +
-For example, suppose that you have a device connected to <color #0B71B9/#DDF1FF>/dev/ttyS0</color>, the first serial port.  You wish to use the US English text table, and the driver should be **automatically detected**.  Here is what you should type at the boot prompt: +
- +
-<code bash> +
-arch32 brltty=auto,ttyS0,en_US +
-</code> +
- +
-Once <color #620BB9/#EEDDFF>brltty</color> is running, you may wish to disable speech.  You can do so via the "<color #620BB9/#EEDDFF>print screen</color>" key, also known as <color #620BB9/#EEDDFF>sysrq</color>.  On my qwerty keyboard, that key is located directly above the insert key, between F12 and scroll lock.+
  
 +Once <color #620BB9/#EEDDFF>brltty</color> is running, you may wish to disable speech.  You can do so via the "<color #620BB9/#EEDDFF>print screen</color>" key, also known as <color #620BB9/#EEDDFF>sysrq</color>.
 ===== Create bootable image ===== ===== Create bootable image =====
 ==== Download live image ==== ==== Download live image ====
Line 357: Line 350:
 ===== 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 388:
 <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 413:
  
 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 482:
 # arch-chroot /mnt # arch-chroot /mnt
 </code> </code>
- 
-  * Write your hostname to <color #0B71B9/#DDF1FF>/etc/hostname</color> 
  
 === Hostname === === Hostname ===
Line 508: Line 504:
 </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 514:
  
 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 529:
 </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 535:
 </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 541:
 </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 557:
  
 <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 614:
 </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 620:
 </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). 
- 
-=== Syslinux === 
 <code bash>  <code bash> 
 # pacstrap /mnt syslinux # pacstrap /mnt syslinux
 </code> </code>
  
-  * Configure <color #0B71B9/#DDF1FF>/etc/mkinitcpio.conf</color> as needed (see man-page for mkinitcpio) and create an initial RAM disk with:+For further details refer to the [[https://wiki.parabola.nu/Syslinux|corresponding article at Parabola]]. 
 + 
 +=== 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:
    
 <code bash> <code bash>
Line 666: Line 640:
 <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 724: Line 672:
  
 ===== 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.+You will now have to create a user and get user privileges like doas. And of course, you will have to install your additional environment for working.
  
 === Configure pacman === === Configure pacman ===
Line 788: Line 736:
 # usermod -aG games <username> # usermod -aG games <username>
 </code> </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.
 +
 +==== Graphical environment and your favorite desktop ====
 +Hyperbola does not include the common known desktop-environments, for example Gnome, KDE, Xfce, Mate, Cinnamon, Budgie, LxDE or LxQT. If you want to know about our reasoning doing so, please read [[en:philosophy:incompatible_packages|here]] more about.
 +
 +You can for sure create your own working graphical environment as we offer several [[en:system:userspace:window_manager|window managers]] and [[en:system:userspace:desktop_enviroment:lumina_desktop|Lumina Desktop]] as working desktop-environment.
 +
 +==== Final note about included packages, applications and others ====
 +
 +We ask to make usage of the [[https://www.hyperbola.info/packages/|package-search]] so you can look out to find packages for your further installation, for example graphical file-managers and more. Hyperbola has not the goal to offer a wide number of packages as we focus on minimalism so far. So we do not have the interest to include more packages!
  
 ===== Conclusion ===== ===== Conclusion =====
-Your new **Hyperbola GNU/Linux-libre** base system is now a **functional GNU/Linux environment**.+Your new **Hyperbola GNU/Linux-libre** base system is now a **functional GNU/Linux-libre environment**. The rest is up to you for a decision which way your system should take.
  
 ===== Acknowledgement ===== ===== Acknowledgement =====
 This wiki article is based on **[[https://wiki.parabola.nu/|ParabolaWiki]]**. We may have removed non-[[https://www.gnu.org/philosophy/free-system-distribution-guidelines.html|FSDG]] bits from it. This wiki article is based on **[[https://wiki.parabola.nu/|ParabolaWiki]]**. We may have removed non-[[https://www.gnu.org/philosophy/free-system-distribution-guidelines.html|FSDG]] bits from it.