Difference between revisions of "Talk:Installation guide"

From ArchWiki
Jump to navigation Jump to search
(GRUB2 Installation)
(Mention the need of virtio modules in mkinitcpio.conf when setting up a guest.)
(One intermediate revision by the same user not shown)
Line 202: Line 202:
Thanks and regards,
Thanks and regards,
[[User:Boism|Boism]] ([[User talk:Boism|talk]]) 21:10, 11 October 2012 (UTC)
[[User:Boism|Boism]] ([[User talk:Boism|talk]]) 21:10, 11 October 2012 (UTC)
In '''Install boot loader'''
It seems there is a typo error: # arch-chroot /mnt pacman -S /mnt grub-efi-x86_64 (remove the second /mnt)
== Mention the need of virtio modules in mkinitcpio.conf when setting up a guest. ==
== Mention the need of virtio modules in mkinitcpio.conf when setting up a guest. ==
Line 211: Line 215:
(Didn't realise about the sig button!)
(Didn't realise about the sig button!)
--[[User:Hiniko|Hiniko]] ([[User talk:Hiniko|talk]]) 12:50, 9 November 2012 (UTC)
--[[User:Hiniko|Hiniko]] ([[User talk:Hiniko|talk]]) 12:50, 9 November 2012 (UTC)
== EFI / GPT too complex to set up with Arch ==
I am not at my first Arch installation, though I had to give up using EFI/GPT to revert to BIOS/MBR so complex is the current procedure. New Arch Linux user may be horrified by this procedure and give up. Fortunately when first I tried Arch, there was a TUI installer supporting GRUB/LVM. Today your are left to the # prompt and this Installation guide that links to too many other guides (UEFI, GRUB2, Partitioning, ...).
--[[User:Mrechte|Marc Rechté]] ([[User talk:Mrechte|talk]]) 07:54, 16 November 2012 (UTC)

Revision as of 07:54, 16 November 2012

Read this first before add new suggestion

  • Point of this page is to not become another Beginner's guide. It's meant to be a concise checklist of things to be done. So detailed install instruction should go to Beginners' Guide.
  • If there is something to discuss which should also affect the Beginner's guide, then do it on Talk:Beginners'_Guide/Installation. An advanced user will find this page less bloated and easier to read, so let's KISS.

GRUB2 Installation

The bootloader section conflicts with instructions from the beginners guide, and lead me to a failed installation, and it has problems, and I believe that should be changed, but I do not have edit privileges so I am writing this instead. The article says to install grub using pacstrap, then it says to install it after chroot, but doing that only leads to pacman saying "already installed and up to date". For me, it only needed installing once, before or after chrooting worked, and I needed to configure grub after chroot, but that was not mentioned at all.

I also do not think this article should be the only instructions in the home directory that installation media boots to, because it is really does not stand on its own and is not at all sufficient when the links are converted to plain text and are not actually links. I'm not going to bother finding the right avenue to change that any time soon though.

--Ian Kelling (talk) 02:54, 16 October 2012 (UTC)

I moved GRUB2 installation after chroot. Otherwise it doesn't work. grub-bios is in /mnt, so we need to tell grub-install about it. But arch iso has grub 0.97, and installation - 2.00, so iso's grub doesn't understand installation's files. --Shuk (talk) 11:42, 23 July 2012 (UTC)

to install grub-bios: install guide say:

Configure the bootloader: refer back to the appropriate article from the bootloader installation section.

at Installation_Guide#Configure_system

At this point I did:

  grub-mkconfig > /boot/grub/grub.cfg


  grub-install /dev/sda


I suggest to add a tip to follow instructions in https://wiki.archlinux.org/index.php/Grub2#Install_to_440-byte_MBR_boot_code_region - I must do it at every installation --Loper

arch-chroot /mnt pacman -S /mnt grub-efi-x86_64 should be changed to arch-chroot /mnt pacman -S grub-efi-x86_64. The first command fails.


GRUB install failure

This doesn't work for me.

It looks so similar to the Beginners' Guide as to be almost redundant, but the first subtle difference I came across meant (for me) that this procedure failed where the Beginners' Guide succeeded.

Under "GRUB" you have:

"Install GRUB2 to the harddrive containing your boot partition before you chroot."

  # grub-install /dev/sda

doing so returns:

"Path /boot/grub is not readable by GRUB on boot. Installation is impossible. Aborting."

In the Beginners' Guide, this step takes place after chrooting, which (for me) works ok, (although the wording - "Install GRUB2 to the harddrive containing your boot partition before you chroot" - is the same, so I guess both wiki entries are at fault). --bananabrain

Link Elinks to wiki

Just read that elinks is included on install iso, maybe add an alias/script to allow loading of wiki guide installation guide? --Mr Green

It's included in the /root directory. thestinger (talk) 18:08, 27 October 2012 (UTC)

Change section "Connect to the internet"

Since the installation guide is now part of the iso image, I'd like to see a few references to the manpages of the necessary tools here, since you cannot open the network related wiki pages. Maybe something like this would be acceptable:

  Assuming a wired ethernet connection, running dhclient or dhcpcd is 
  sufficient to get a lease. Otherwise set up the connection manually
  using ip add, wpa_supplicant (WLAN with WPA), pppoe-setup (DSL), etc.
  You can also create and use netcfg profiles. Read more in the manpages:
  ip(8), wpa_supplicant(8), pppoe(8), netcfg(8), netcfg-profiles(5)

A reminder to install the packages for the internet connection in the pacstrap section would also be nice. -- progandy

Suggestions to update this guide as part of ISO

Since this guide is now being included as 'install.txt' in the ISO, it might be beneficial to incorporate the following changes:

  • Entirely remove the 1. Download section and move it to the Download area of the archlinux.org page. This document here is about installing, not downloading, checking, burning discs or dd'ing. The majority of users reading this have likely already booted up the install medium.
  • Begin or end the document by mentioning the new archlinux(7) man page which explains the location of important system configuration files
# man archlinux
  • Slightly expand the 6. Connect to the internet section to include the most basic examples of setting up a private network using a dynamic and static IP address. (Right now it's only a single paragraph/line.) It's a vital installation step and should actually be moved to the top as one of the first actions during system setup. This fact should be emphasized.

Obtain dynamic IP

# dhcpcd

Set static IP

# ip link set dev eth0 up
# ip addr add dev eth0
# ip route add default via
# echo "nameserver" >> /etc/resolv.conf


  • I can agree to all your suggestions, I wonder why no one is modifying the wiki. Internet connection setup is the most important part and should be covered more extensively. In addition to your changes, mention the manpages and configuration templates for netcfg and pppoe-setup/connect. The boot medium must at least contain easy accesible information in order to read all pages referenced in the installation guide. There should also be mentioned that elinks is installed and can be used to access the wiki. --Progandy (talk) 21:50, 24 August 2012 (UTC)
  • The dhcpcd network daemon is started automatically: [1], [2], so there's no reason to start it manually. --DSpider (talk) 08:17, 25 August 2012 (UTC)


As this guide mentions the loading of keymaps using loadkeys there should be at least a very small example about /etc/vconsole.conf

Either not talk about keymaps or tell how to make it correct. When this is used as a checklist, the setup of the keymap should not be missing.

KEYMAP page link added. Close. -- Fengchao (talk) 04:03, 4 September 2012 (UTC)
The section on keymaps and fonts links only to the KEYMAP page. An additional link regarding setting default console font should be added to:


add a step: setting the clock

Lots of things care about the clock being more-or-less correct, e.g. pacman-key will not work at all if the clock is too far out. Lots of brand new computers come with the clock set to something in the distant past, which causes weird problems during the install. Thetrivialstuff (talk) 23:14, 31 July 2012 (UTC)

pacman-key --init / populate?

Isn't this a required step? pacstrap does not seem to do it on its own. Thetrivialstuff (talk) 23:15, 31 July 2012 (UTC)

Edit: Ah; I think this was related to the "set the clock" step -- I see that there is a pacman keyring init in the boot sequence of the latest media, but it (silently?) fails if the local clock is wrong.
https://mailman.archlinux.org/pipermail/arch-releng/2012-July/002708.html --Bluewind (talk) 09:10, 1 August 2012 (UTC)

Link to UEFI Bootloaders page

Instead of telling the user to install GRUB(2) alone in case of UEFI, direct the reader to the UEFI_Bootloaders page which provides info about all the UEFI bootloaders capable of booting linux kernel. Also how can I edit the guide, there is no "edit" tab shown on top of the page. Is this page restricted to few authors only? -- Keshav P R (talk) 15:31, 19 August 2012 (UTC)


  • The "Install a bootloader" section should be a bullet point above "Configure the bootloader: refer back to the appropriate ...", no need to have them separate. Using pacstrap to install the bootloader just seems silly (especially since they were also merged in the Beginner's Guide). Also, commands after arch-chroot would look better if they were indented with ": {{bc|# <command>}}", kinda like how # pacman-key -v <iso-file>.sig is at the beginning of the article. Would look much cleaner. --DSpider (talk) 16:33, 20 August 2012 (UTC)

Proposed changes to Beginners' Guide and link to Post-Installation

Some major changes are under discussion in Talk:Beginners'_Guide#Guide_restructuring: some of them would require adjustments to this very guide, see for example this post.

Please reply in the linked discussion, not here.

-- Kynikos (talk) 12:15, 22 September 2012 (UTC)

I've added the steps in Beginners' Guide/Post-Installation to this guide, which now directly sends users to Beginners' Guide/Extra.
If however Talk:Beginners' Guide#Guide restructuring will be implemented as planned, the Beginners' Guide will have a slightly different installation procedure than this guide, unless this one is updated too.
-- Kynikos (talk) 14:08, 24 September 2012 (UTC)
Shouldn't the information be added before "Unmount leftovers and reboot" ? By the way, the title should mention rebooting, because most likely a kernel update was involved. --DSpider (talk) 14:41, 24 September 2012 (UTC)
The link to Post-Installation was the last step of the guide, so that's the line I've replaced with the instructions from Post-Installation.
About rebooting in case of a kernel upgrade, I don't think it's necessary to state that since this guide is aimed at experienced users.
In any case, any reordering or modification of the various steps should better be approved by a Developer, and probably the forum or the mailing lists are better places than this talk page to involve them in such discussions.
-- Kynikos (talk) 14:59, 24 September 2012 (UTC)
Yeah, but at this point, you were instructed to reboot. In order to edit pacman.conf, you need to mount the root partition. And to update your system, you need to chroot into it. It would be better if "Unmount leftovers" was renamed "Unmount leftovers and reboot", and added at the end (before the suggestion to read the instructions from Extra). --DSpider (talk) 15:07, 24 September 2012 (UTC)
You are still instructed to reboot, aren't you? The "Unmount leftovers" section currently tells you to "reboot and then login into the new system with the root account". In the "new system", the correct partition is already mounted at /.
Whether or not configuring pacman, updating the system and adding a user would be better done in the chroot before rebooting, it's something that should be discussed with a Developer. I too think that it would make more sense, requiring one less reboot in case of a kernel upgrade.
-- Kynikos (talk) 15:18, 24 September 2012 (UTC)
Renaming "Unmount leftovers" to "Unmount leftovers and reboot" is safe anyway, so I've done that. -- Kynikos (talk) 15:37, 24 September 2012 (UTC)
@DSpider: you're quite active on the forum, why don't you propose your idea there? I think it would be interesting to discuss it. -- Kynikos (talk) 14:11, 25 September 2012 (UTC)
Ok, after reading this I realize that maybe I haven't been clear enough, so I'll try to explain everything more thoroughly.
  1. The current procedure makes you configure the system in the chroot environment from the live system.
  2. Then, still in the live system, it asks you to exit the chroot, unmount the partitions for the new system, reboot and login into the new system. Now, I refuse to write more explicitly in the guide that you should boot into the new system, and not again in the live system, in order to login into the new system.
  3. Since you are now into the new system (not the live system), the root partition is mounted at /, not at /mnt/, so you should be able to configure pacman, update the system and add a user wihtout chrooting. Now, if you've tested the procedure and really noticed that for some obscure-to-me reason you still need to chroot to /mnt in order to do those operations, please ask for clarifications in the forum because I wouldn't be able to answer any more.
Last thing, and I think this is the 3rd or 4th time I write it, I agree with you that configuring pacman etc. could easily be done in the chroot environment at step 1, but you should propose that change in the forum first, since it would be a change in the official installation procedure and I won't take responsibility for that.
I think this is the best I can do here, the next step to explain all this could be making a movie or a five-act play, but I hope it's not necessary :)
-- Kynikos (talk) 05:56, 30 September 2012 (UTC)

locale warning when running mkinitcpio

Error is "bsdcpio: Failed to set default locale"

Discussion in IRC suggests 3 options:

  • Tell user to ignore locale warning from mkinitcpio
  • add export LANG=... command to match your locale.conf
  • relog (maybe not a good idea because of preparing chroot again)


Velusip (talk) 15:31, 23 September 2012 (UTC)

"Configure the network" is missing

Basically, you establish an internet connection, but you also need to configure the network, so that you can connect after rebooting. The Beginners' Guide mentions it: You need to configure the network again, but this time for your newly installed environment. The procedure and prerequisites are very similar to the one described above, except we are going to make it persistent and automatically run at boot. And this information seems to be missing from the installation guide. --DSpider (talk) 13:51, 3 October 2012 (UTC)

I don't think that any Developer is watching this talk page, you'd better report this in the forum or mailing list. -- Kynikos (talk) 10:43, 4 October 2012 (UTC)
I'm not sure if this should be a part of the installation guide. -- Karol (talk) 15:20, 29 October 2012 (UTC)
Of course it should. Because after rebooting (which you are instructed to), you're left with a borked machine. You need to boot the installation media again, establish an internet connection, mount the partitions and chroot into your system, and only THEN install the required packages. There should at least be a line that mentions netcfg. Because I read that it can handle both wired and wireless connections, and it's included in base now. --DSpider (talk) 07:04, 30 October 2012 (UTC)
I'm sorry if I'm missing something, but there is a line about netcfg already and was there a month ago when this discussion was started. If you want to add a note that after rebooting the user has to enable dhcpcd service etc. (so he should have all the needed packages installed beforehand) that's fine with me. -- Karol (talk) 10:09, 30 October 2012 (UTC)

Install a bootloader

Make it more visible that it is a choise between Grub/Syslinux.

2 amendments to do

In Configure the system:

There is only one link on

   Add console keymap and font preferences in /etc/vconsole.conf

This link should apply only to "console keymap".
"font preferences" should link to Fonts#Console_fonts

There is also:

   Uncomment the selected locale in /etc/locale.gen and generate it with locale-gen.

This should be removed as it has been already done during this step:

    Set locale preferences in /etc/locale.conf.

Thanks and regards, Boism (talk) 21:10, 11 October 2012 (UTC)

In Install boot loader

It seems there is a typo error: # arch-chroot /mnt pacman -S /mnt grub-efi-x86_64 (remove the second /mnt)

Mention the need of virtio modules in mkinitcpio.conf when setting up a guest.

When setting up a guest you need the module virtio_blk in your init ramdisk to boot off the guest drive and optionally virtio_pci and virtio_net for other devices. Probably a quick mention and a link to the page I found this in would be enough, however I can't find the wiki / forum page I found this on annoyingly.

This one had me a bit stumped for a day, maybe more because I was ignorant of some details of virtualisation I think, still I think it is worth a quick mention as it isn't painfully obvious from searching about.

(Didn't realise about the sig button!) --Hiniko (talk) 12:50, 9 November 2012 (UTC)

EFI / GPT too complex to set up with Arch

I am not at my first Arch installation, though I had to give up using EFI/GPT to revert to BIOS/MBR so complex is the current procedure. New Arch Linux user may be horrified by this procedure and give up. Fortunately when first I tried Arch, there was a TUI installer supporting GRUB/LVM. Today your are left to the # prompt and this Installation guide that links to too many other guides (UEFI, GRUB2, Partitioning, ...).

--Marc Rechté (talk) 07:54, 16 November 2012 (UTC)