| Both sides previous revision
Previous revision
Next revision
|
Previous revision
|
pt:manual:installation [2022/03/08 02:39]
i3_relativism ↷ Page moved from pt:installation:installation to pt:manual:installation |
pt:manual:installation [2025/02/26 16:25] (current)
luck02 [Partition disks] |
| ... (WIP) | ... (WIP) |
| |
| ====== The Installation Guide ====== | ====== O Guia de Instalação ====== |
| |
| The Installation Guide for Hyperbola live-CD image (launchable from USB thumb-drive, too) is intended to assist experienced GNU/Linux users in installing **Hyperbola** from the live system booted with the official installation image. This page assumes a **high-level of experience** with GNU/Linux systems and utilities, especially the command line. If you'd like a more detailed, step-by-step guide through the installation process, see the [[en:guide:Beginners|Beginners guide]]. Before beginning, we recommend you view our [[en:main:FAQ]], the [[https://wiki.archlinux.org/index.php/Frequently_asked_questions|Arch FAQ]] , and employ the <color #620BB9/#EEDDFF>man ''command''</color> to read the man page of any command they are not familiar with. The Hyperbola wiki (known as **HyperWiki**), as well as the **ArchWiki**, should be the primary source of information and your first resource during trouble-shooting. | O Guia da Instalação para a imagem live-CD da Hyperbola (launchable from USB thumb-drive, too) is intended to assist experienced GNU/Linux users in installing **Hyperbola** from the live system booted with the official installation image. This page assumes a **high-level of experience** with GNU/Linux systems and utilities, especially the command line. If you'd like a more detailed, step-by-step guide through the installation process, see the [[archive:en:manual:beginner_installation|Beginners guide]]. Before beginning, we recommend you view our [[en:project:faq]], the [[https://wiki.archlinux.org/index.php/Frequently_asked_questions|Arch FAQ]] , and employ the <color #620BB9/#EEDDFF>man ''command''</color> to read the man page of any command they are not familiar with. The Hyperbola wiki (known as **HyperWiki**), as well as the **ArchWiki**, should be the primary source of information and your first resource during trouble-shooting. |
| |
| ===== Download ===== | ===== Download ===== |
| |
| Download the new **Hyperbola ISO** from the [[en:main:downloads|download page]]. | Download the new **Hyperbola ISO** from the [[en:project:downloads|download page]]. |
| * Instead of six different images we only provide a **single one** which can be booted into an **i686** and **x86_64** live system to install **Hyperbola GNU/Linux-libre** over the network. | * Instead of six different images we only provide a **single one** which can be booted into an **i686** and **x86_64** live system to install **Hyperbola GNU/Linux-libre** over the network. |
| * Install images are **signed** and it is highly recommend to **verify their signature** before use. On **Hyperbola**, this can be done by using <color #620BB9/#EEDDFF>pacman-key -v <iso-file>.sig</color> | * Install images are **signed** and it is highly recommend to **verify their signature** before use. On **Hyperbola**, this can be done by using <color #620BB9/#EEDDFF>pacman-key -v <iso-file>.sig</color> |
| * The image can be burned to a **CD**, mounted as an **ISO** file, or directly written to a **USB stick** using a utility like <color #620BB9/#EEDDFF>dd</color>. It is intended for new installations only; an existing **Hyperbola GNU/Linux-libre** system can always be updated with <color #620BB9/#EEDDFF>pacman -Syu</color>. | * The image can be burned to a **CD**, mounted as an **ISO** file, or directly written to a **USB stick** using a utility like <color #620BB9/#EEDDFF>dd</color>. It is intended for new installations only; an existing **Hyperbola GNU/Linux-libre** system can always be updated with <color #620BB9/#EEDDFF>pacman -Syu</color>. |
| |
| ===== Blind and visually impaired users ===== | ===== Usuários cegos e com deficiência visual ===== |
| |
| There is a ISO called [[en:main:downloads#HyperTalking|]] that is a derivative install CD based on **TalkingArch** and a respin of the Hyperbola ISO modified to include speech and braille output. | There is a ISO called [[en:project:downloads#HyperTalking]] that is a derivative install CD based on **TalkingArch** and a respin of the Hyperbola ISO modified to include speech and braille output. |
| |
| ===== Writing a Hyperbola ISO image to an USB drive ===== | ===== Escrevendo uma imagem ISO Hyperbola para uma unidade USB ===== |
| |
| <code bash> | <code bash> |
| <note>''**[usb device file]**'' is the path to the **USB device** file. <color #620BB9/#EEDDFF>dmesg</color> or <color #620BB9/#EEDDFF>lsblk --fs</color> can be used to learn this path. It is often similar to device filenames of storage devices like hard drives and SSDs, e.g. <color #0B71B9/#DDF1FF>/dev/sdb</color> '''**It is very important to use the correct value**''' to avoid overwriting other storage devices.</note> | <note>''**[usb device file]**'' is the path to the **USB device** file. <color #620BB9/#EEDDFF>dmesg</color> or <color #620BB9/#EEDDFF>lsblk --fs</color> can be used to learn this path. It is often similar to device filenames of storage devices like hard drives and SSDs, e.g. <color #0B71B9/#DDF1FF>/dev/sdb</color> '''**It is very important to use the correct value**''' to avoid overwriting other storage devices.</note> |
| |
| ===== Installation ===== | ===== Instalação ===== |
| |
| |
| ==== Keyboard layout ==== | ==== Layout do teclado ==== |
| |
| For many countries and keyboard types appropriate keymaps are available already, and a command like <color #0B71B9/#DDF1FF>loadkeys uk</color> might do what you want. More available keymap files can be found in <color #0B71B9/#DDF1FF>/usr/share/kbd/keymaps/</color> (you can omit the keymap path and file extension when using <color #620BB9/#EEDDFF>loadkeys</color>). | For many countries and keyboard types appropriate keymaps are available already, and a command like <color #0B71B9/#DDF1FF>loadkeys uk</color> might do what you want. More available keymap files can be found in <color #0B71B9/#DDF1FF>/usr/share/kbd/keymaps/</color> (you can omit the keymap path and file extension when using <color #620BB9/#EEDDFF>loadkeys</color>). |
| === Braille Support === | === Braille Support === |
| |
| [[en:main:downloads#HyperTalking]] includes **brltty**, for those who own braille displays. The [[https://www.hyperbola.info/packages/?q=brltty|brltty]] package available on the [[en:main:downloads#HyperTalking]] 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#HyperTalking]] includes **brltty**, for those who own braille displays. The [[https://www.hyperbola.info/packages/?q=brltty|brltty]] package available on the [[en:project:downloads#HyperTalking]] 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. |
| |
| 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. I encourage you to read the <color #620BB9/#EEDDFF>brltty</color> documentation for a fuller explanation of the program. |
| 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>. On my qwerty keyboard, that key is located directly above the insert key, between F12 and scroll lock. |
| |
| ==== Partition disks ==== | ==== Partição dos Discos ==== |
| |
| See [[https://wiki.archlinux.org/index.php/Partitioning|partitioning]] for details. | See [[https://wiki.archlinux.org/index.php/Partitioning|partitioning]] for details. |
| |
| <note important> | <note important> |
| Keep in mind these steps will fail if your system is not set to the correct time, or if you are not connected to the internet. See [[en:guide:installation#connect_to_the_internet|above]] for internet setup instructions. | Keep in mind these steps will fail if your system is not set to the correct time, or if you are not connected to the internet. See [[en:manual:reference_installation#connect_to_the_internet|above]] for internet setup instructions. |
| </note> | </note> |
| |
| </code> | </code> |
| |
| * Install GRUB after chrooting (refer to the [[en:guide:Installation#Configure the system]] section). | * 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. | See [[https://wiki.parabola.nu/GRUB2|GRUB]] for further details. |
| </code> | </code> |
| |
| * Set [[en:guide:beginners#locale|locale]] preferences in <color #0B71B9/#DDF1FF>/etc/locale.conf</color> | * Set [[archive:en:manual:beginner_installation#locale|locale]] preferences in <color #0B71B9/#DDF1FF>/etc/locale.conf</color> |
| * 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> |
| * Uncomment the selected locale in <color #0B71B9/#DDF1FF>/etc/locale.gen</color> and generate it with <color #620BB9/#EEDDFF>locale-gen</color> | * Uncomment the selected locale in <color #0B71B9/#DDF1FF>/etc/locale.gen</color> and generate it with <color #620BB9/#EEDDFF>locale-gen</color> |
| |
| <note important> | <note important> |
| If you want to [[en:guide:encrypted_installation|install GRUB on a Libreboot system]], keep in mind your system **does not use UEFI or Legacy BIOS**, but instead loads GRUB as its only payload. So you we will run this command instead: | If you want to [[en:manual:fde_installation|install GRUB on a Libreboot system]], keep in mind your system **does not use UEFI or Legacy BIOS**, but instead loads GRUB as its only payload. So you we will run this command instead: |
| |
| <code bash> | <code bash> |
| |
| <note tip> | <note tip> |
| If you are following the [[en:guide: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. | If you are following the [[en:manual:fde_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> | </note> |
| |
| ==== Configure speech support (for blind and visually impaired users) ==== | ==== Configure speech support (for blind and visually impaired users) ==== |
| |
| If you are using [[en:main:downloads#HyperTalking]] and need start speech support when you boot the system, you will need to do: | 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]]. | * Install [[https://www.hyperbola.info/packages/?q=espeakup|espeakup]] and [[https://www.hyperbola.info/packages/?q=alsa-utils|alsa-utils]]. |
| Edit <color #0B71B9/#DDF1FF>/etc/pacman.conf</color> and configure pacman's options, also enabling the repositories you need. | Edit <color #0B71B9/#DDF1FF>/etc/pacman.conf</color> and configure pacman's options, also enabling the repositories you need. |
| |
| See [[https://wiki.archlinux.org/index.php/Pacman|Pacman]] and [[en:main:Repositories]] for details. | See [[https://wiki.archlinux.org/index.php/Pacman|Pacman]] and [[en:project:repositories]] for details. |
| |
| ==== Update the system ==== | ==== Update the system ==== |