TheAlternative Logo

1 Introduction

This is a concise guide to install Linux. It can be used as a standalone guide, although we recommend that you attend our Install Events during the LinuxDays so that experienced users can help you with your installation.

The guide help you to create an install stick, prepare your existing operating system and finally install Linux. We also included some links to distribution-specific installation resources, for the most up-to-date instructions.

At the end of the guide, we include some software recommendations.

1.1 Overview

Installing Linux is done in three steps:

  • Flash an USB Stick with the Linux installer
  • Prepare your existing operating system
  • Install Linux

We will help you at each step. If you encounter problems or have suggestions how to improve this guide feel free to reach out!

1.2 LinuxDays Install Event

You can skip this part if you do not physically attend the install events

Welcome to the LinuxDays Install Event! We are happy you could make it.

1.2.1 Staff

Our staff is easily recognizable by their blue T-Shirts. Feel free to ask them about Linux, TheAlternative, Free Software or anything else.

We will help you if you are unable to proceed with the install guide or have any other questions. If we do not have an immediate answer, we know who to ask or where to look it up.

Also, feel free to stay and just chat :)

1.2.2 Demolaptops

We have prepared some laptops with different distribution and desktop environments. You can try them out, and decide what you like best.

If you do not really care or can not decide, we will try to recommend something based on what you want to use Linux for.

1.2.3 USB Install Sticks & Install Guide Copies

We have prepared USB Install Sticks so you can get started right away with installing Linux.

Further, we have printed copies of the Install Guide if you rather have a printed version than look at it on you phone.

1.2.4 Anything else?

We have adapters (like USB to LAN), hubs, mouse and keyboards, …

2 Flash Stick

You will prepare a stick from which you can install Linux from.

If you are at one of our Install Events, we already prepared USB sticks. Choose a distribution (read on) then come to the welcome desk to get your stick.

2.1 Choosing a distribution

In the words of Richard Stallman:

What you’re referring to as Linux, is in fact, GNU/Linux, or as I’ve recently taken to calling it, GNU plus Linux. Linux is not an operating system unto itself, but rather another free component of a fully functioning GNU system > made useful by the GNU corelibs, shell utilities and vital system components comprising a full OS as defined by POSIX."

In simpler terms: Linux by itself is not a full operating system (rather than a vital technical part of it). You need to choose a distribution (a “wrapper” around Linux) which will define to a large extend how you as a user will interact with the operating system (like installing new programs, how the desktop looks by default, …).

As choosing a distribution is heavily opiniated, we describe it here very short. Feel free to reach out to us for a personal recommendation based on your specific needs.

If you “just want Linux”, we recommend you go with Ubuntu. As a more open but also very stable alternative we recommend Fedora. Truly Free (as in Freedom!) is FreeBSD.

For each of these distributions we give you starting points for a successful installation. If you want to install other distributions feel free to do so; and we will do our best to help you. If you are an enthusiast and want to try to install something more advanced (like Arch Linux) come join us :).

2.2 Download ISO

You need to download an image containing the operating system installer. Visit the webpage of your favourite distribution and download it.

If you have to choose from multiple versions, here some guidance of commonly used terms:

  • amd64, i386, … refers to the architecture of your device. If you have a laptop / PC, it is very likely that you need amd64 (else you’d probably know it).
  • LTS stands for long term support; meaning this specific version of the distribution will receive security updates for much longer than other versions.

2.3 Create install USB Stick

Get a USB stick of at least 8 Gb (make sure you do not need the data on it anymore!). Flash (=“Put”) the .iso file you have just downloaded on the USB stick.

On windows, you can use rufus. On macOS, you can use etcher.

3 Prepare Windows / Mac

If you want to keep your existing operating system (Windows or macOS) you need to prepare it. This will allow you to “double-boot”, hence choose at startup which operating system to run.

If you do not want to keep your existing operating system, you can skip this section.

3.1 About Partitioning

Disk partitioning is the separation of different regions on a hard drive or an SSD. This separation is used to install two different operating systems on a computer or simply to have different regions for different purposes (like a partition for your data and one for the programs).

We recommend to have at least 40GB of space partitioned for Linux. If you know you need programs for your studies (e.g. Matlab, which is around 30GB), please have enough free disk space to install the desired programs and probably some extra, just in case.

Be aware that repartitioning later is practically impossible, so try to be on the safe side. If you do not have space constraints, with 100Gb all you wildest wishes should be fulfillable.

3.2 Windows 10

If you have Windows (and want to keep it) follow on.

3.2.1 Making Space for Linux

Shrink Windows partition:

  • Open create and format hard disk partitions or diskmgmt.msc.
  • Look for the large Windows partition at the bottom.
  • Right-click on it and select Shrink Volume...
  • Shrink it so you have enough space available.

If you are unable to shrink the partition, use a tool like EaseUS Partition Master or try it in the Linux installer. Ask a helper for assistance.

If you do not have enough space, you can free up disk space with these tips:

  • Open Disk Cleanup and click on Clean up system files. Select all that apply.
  • Open Add or Remove Programs and remove unneeded programs
  • Download WinDirStat from https://windirstat.net/ and find where the large files are hiding

3.2.2 Disable Bitlocker

Bitlocker encrypts your disk, but unfortunately it is not compatible with Linux boot loaders.

Disable Bitlocker:

  • Open cmd as administrator: Press Windows Key, type cmd, then right click on Command Prompt and select Run as administrator)
  • Type manage-bde -status and look for Conversion Status: Fully Decrypted
  • For any drive which is not Fully Decrypted, type manage-bde -unlock C: (replace C: with the drive you need to decrypt), and press Enter.
  • Wait for decryption to end (execute manage-bde -status for status updates)

You can also try to disable Bitlocker over the UI (look for Manage Bitlocker) but it has been confusing to do so in the last few years.

3.2.3 Fast Boot

Fast boot allows Windows to boot faster, but when it is active, the windows file system will be inaccessible to other OSes (like Linux).

You can avoid the Fast boot mode by explicitly choosing to Restart (rather than Shut down) in windows.

Alternatively, you can simply disable fast boot:

  • Find the battery icon in the task bar
  • Right-click and select Power Options
  • Select Choose what the power buttons do
  • Select Change settings that are currently unavailable
  • Remove the check mark at Turn on fast startup

3.2.4 Booting the installer

Make sure your Linux install stick is plugged into your PC.

Click Restart in the Windows start menu, while holding down the Shift key. A Please wait-text appears, after which Windows should enter the troubleshooting menu.

From this menu you can choose a startup device, or enter the UEFI settings.

  • To choose the startup device, select Use a device. As we want to boot from the Linux USB stick choose USB FDD or similar.
  • To enter the UEFI settings, select Troubleshoot, Advanced Options and then UEFI Firmware Settings.

If none of this works, you can try to change the startup device immediately after booting. This guide will explain how in the next chapter.

3.3 macOS

Note that on modern Apple computers it is generally not advisable to install Linux (MacBooks after 2016 simply are not very compatible with Linux.)

Up-to-date information on the status of Linux support on MacBooks can be found here.

3.3.1 Shrink your OS X partition

On OS X, we will resize your existing partition to make space for your new Linux system.

  • Go to /Applications/Utilities and open the Disk Utility.
  • Select your main disk in the list to the left (usually the first or the largest).
  • Select the tab Partition.
  • On the left side there is a white rectangle with some blue threshold indicating the space consumed by Mac OS X.
  • Click and hold the lower right corner of that rectangle and draw the cursor upwards, to shrink the volume.
  • The text on the right will give you information about the freed memory.
  • Once you are satisfied, click Apply to confirm the shrinking operation.

3.3.2 Install rEFInd

We will install the bootloader on OS X before the Linux installation. rEFInd will boot your USB Install Medium as well as your operating system later on.

  • Browse the web for http://www.rodsbooks.com/refind/getting.html and scroll down a bit to click the link A binary zip file.
  • Once the download has completed, go to the Download folder and extract the file.
  • Open a Mac terminal by going to Application/Utilities and opening Terminal.
  • Type cd (with a space afterwards, but do not press Enter yet) and drag the extracted folder into the terminal.
  • Now, hit Enter and then type ./refind-install.
  • When prompted for your password, enter it. (You won’t see what you enter at the password prompt at all. You have to enter your password blindly.)

3.3.3 Troubleshoot

In case you get an error message saying ALERT: SIP ENABLED, you need to do the following:

  • Turn off your Mac and start it again, pressing Cmd + R immediately after turning it on again (you might want to hold it for a while).
  • Your Mac should boot in recovery mode. Go to Utilities and open up a terminal.
  • Now type: csrutil disable.
  • Then reboot back into your normal system and try to install rEFInd again.
  • After installation, feel free to go once more into recovery and type csrutil enable.

3.3.4 Booting the installer

We will now boot from your USB Install Medium.

  • Plug your USB Install Medium into your laptop.
  • Reboot your machine and rEFInd should see the USB key.
  • Your USB installer may have several ways to boot. They all will show up and have a little USB icon to the bottom right.
  • Usually the first USB installer is correct. If it doesn’t work, reboot and try the others.
  • If your USB installer doesn’t show up, hit Escape to refresh the list. It should show up now.
  • If you see multiple USB keys, try each of them until you find the Linux installer.

4 Install

You are all set to install Linux on your device.

If you have not yet done so; ensure you have backed up all your data! In the (unlikely) case something goes terribly wrong, you can recover your data.

4.1 Boot from Stick

You now want to boot from the USB stick (if you have not already done so, depending on your existing operating system).

This step can be tricky, as the way to accomplish this is different over different devices and brands. Generally you need to look for something like “BIOS” or “startup device”. You then need to choose the USB stick as the startup device.

You can enter the BIOS or change the startup device usually with the function keys (such as F1, F8, F10, F12) or with other keys like ESC or Enter.

The most common keys by brand: - Lenovo: Enter - HP: Esc

4.2 Partitioning

This can either be done automatically by the Linux distributions installer, or manually if you want more control over your setup. If you are unsure about what setup you want, it might be best to follow the automatic setup.

Example partitions for a system with Linux only
Example partitions for a dual boot system

4.2.1 Automatic setup

The various installers usually offer an option to either install alongside an existing operating system (Windows/Mac), or to use the entire disk and erase previously installed systems. If you choose to install alongside something else, there is usually an option to choose how much space you want to allocate for the new system. Note that the partition for the old system will also have to shrink by this amount.

4.2.2 Manual setup

If you want a manual setup these are some partitions you might consider:

  • /boot: This is the boot partition for EFI. This already exists and will be reused when installing your new operating system.
  • / (root). A root partition is required for all installations. This is where all the operating system files live.
  • /home: Some users like to their home directory on a different partition. This can make re-installation of a distribution easier. However, this is entirely optional.
  • /swap: A swap partition is used as an extension for your machines memory, if it ever fills up. Nowadays, a lot of people omit this on personal computers.

You will also be able to choose a file system for / and /home. Almost always the ext4 filesystem should be used. If you know what you are doing, you can of course also choose something else.

4.3 Ubuntu

We recommend to follow the official install-guide for installing Ubuntu.

As further resources, we recommend the Ubuntu Wiki and the askubuntu StackExchange.

4.4 Fedora

The top-level documentation for Fedora can be found on the official Fedora docs website.

The following links are a good starting point:

4.5 Open SUSE

For getting started with OpenSuse we recommend going through Unofficial openSUSE Guide, since it gives a good overview and can save you some time.

Also check out the Start-Up Guide from their website and the documentation if you have further questions or want to work with the official material.

5 Software

These are software recommendations for Linux. Most of these are graphical programs, but there are some programs that run in the terminal only. Note that these programs have various licenses, some might not even be “libre” software (due to them becoming closed source at a later point, or this list having errors)!

Some programs are annotated if they are best used on GNOME or KDE. This does not mean they cannot be used on the other environment, but the visual integration might be lacking in these cases.

5.1 Office

Use caseApplicationComment
Office suiteLibreOffice
Office suiteOnlyOfficeLooks much nicer than LibreOffice
PDF viewerZathuraAll desktop environments include a PDF viewer. Zathura is another, more simple option.
Note taking, PDF annotationXournal
LaTeX editorTexstudio, Texmaker, GNOME LaTeXTexstudio/Texmaker are “what you see is what you get”, GNOME LaTeX uses a “write, then compile” workflow.
Mindmappingvym
Design/PublishingScribus
Simple Text EditorGedit/Geany (GNOME), Kwrite/Kate (KDE)
Advanced Text Editorvim, emacsThese are a bit more difficult to learn, but are very popular with power users.
File managerPCManFM, ranger/nnn (Terminal)All desktop environments include a file manager, these are other more advanced options.
CADFreeCAD

5.2 Graphics

Use caseApplicationComment
Image editingGIMP, PintaGIMP is a more fully featured editor, similar to Photoshop. Pinta is inspired by Paint.NET.
PaintingKrita
3D AnimationBlender
Photo managementDarktable, Digikam
ScanningSkanlite (KDE), SimpleScan (GNOME)
OCR (Text Recognition)OCRGui, OCRmyPDF (Terminal)

5.3 Multimedia

Use caseApplicationComment
Video Playermpv, VLC, Totem (GNOME)Desktop environments have a default video player, but mpv/VLC are usually more powerful.
Audio editingAudacity
MP3 taggingPicard
Digital Audio Workstation (DAW)Ardour
YouTube downloaderyoutube-dl (Terminal)Requires regular updates, because YouTube changes their website rather often
Screen recordingOBS, SimpleScreenRecorderOBS is very powerful, SimpleScreenRecorder is more simple option.

5.4 Scientific

Use caseApplicationComment
MatlabPython+Numpy, OctaveOctave tries to be similar to Matlab, while Python+Numpy is rather different.
StatisticsR, PSPP
ArcGISQGIS, GRASS GIS

5.5 Internet

Use caseApplicationComment
Web BrowserFirefox, Chromium, qutebrowserWe recommend using Chromium instead of Google Chrome on Linux
MailThunderbird, KMail (KDE), Evolution (GNOME), mutt (Terminal)
Instant MessagingTelegram, Pidgin, Empathy (GNOME)
Torrent clientTransmission (GNOME), Ktorrent (KDE), Deluge, rtorrent (Terminal)
Voice chatMumble, Empathy (GNOME)
File synchronizationSyncthing, Nextcloud, OwnCloud, Seafile

5.6 System

Use caseApplicationComment
Disk usageBaobab (GNOME), Filelight (KDE), ncdu (Terminal)
Virtualizationvirt-manager, VirtualBox, GNOME Boxes
Backupborg backup, Déjà Dup
System monitorhtop (Terminal)The desktop environment have their own system monitor included.

5.7 Development

Use caseApplicationComment
IDEIntelliJ, Eclipse, Code::Blocks, Android Studio, Geany, Qt Creator, Gnome BuilderSome of these might not be Free and Open Source!

5.8 Other

Use caseApplicationComment
Dropdown terminalGuake (GNOME), Yakuake (KDE)
Clipboard managerGlipper (GNOME), Clipman (XFCE)The desktop environment each have their own clipboard manager.

6 Troubleshooting

A chapter for some advanced troubleshooting. If you need something contained in this chapter, better ask some advanced user for help (or one of our helpers if you are at our Install Event).

6.1 Microsoft Surface

6.1.1 Something doesn’t work

Microsoft Surface devices usually require a patched kernel. See this project to install such a kernel.

6.2 Wireless

6.2.1 Broadcom on Ubuntu doesn’t work

See this.

6.2.2 Installing Broadcom Firmware

openSUSE:

sudo zypper install b43-fwcutter sudo /usr/sbin/install_bcm43xx_firmware

See also this site.

Ubuntu:

sudo apt install firmware-b43-installer

See also this site.

6.3 OpenSUSE

6.3.1 Installing Broadcom Wireless Drivers (broadcom-wl)

  • Add the packman repo: YaST -> Software repos -> Add -> Select community -> repos -> Next -> Select packman -> Finish
  • zypper ref
  • zypper install broadcom-wl

6.4 Graphics drivers

6.5 System hangs at boot (NVIDIA present)

Boot with nomodeset kernel parameter, then either install proprietary NVIDIA drivers or disable the NVIDIA graphics entirely.

6.6 I want to disable the Nouveau driver

echo 'blacklist nouveau' | tee /etc/modprobe.d/blacklist.conf

6.7 Acer

Some types of newer Acer notebooks need special settings for Secure Boot in order to boot an installed GNU/Linux system at all. If you installed eg. Ubuntu but it directly boots Windows without giving you a GRUB selection screen, try the following guide: https://askubuntu.com/questions/771455/dual-boot-ubuntu-with-windows-on-acer-aspire/771749#771749

6.8 System

6.8.1 chroot into an installed system

To chroot into an installed system from a live iso, do the following:

  • sudo su
  • mount /dev/sdaX /mnt, where sdaX is your root partition
  • If you have EFI: mount /dev/sda1 /mnt/boot/efi (assuming sda1 is your EFI partition)
  • mount -t proc proc /mnt/proc/
  • mount -t sysfs sys /mnt/sys/
  • mount -o bind /dev /mnt/dev/
  • chroot /mnt /bin/bash

6.8.2 Cleaning up boot entries

  • efibootmgr prints all boot entries.
  • efibootmgr -o XXXX,YYYY,ZZZZ sets the boot order.
  • efibootmgr -b <number> -B deletes an EFI boot entry.

6.8.3 Drives are not found in the installer

Especially newer laptops (2018+) have options to switch between RAID and AHCI boot mode.

If the laptop is running in RAID mode and Linux does not recognize its drives, it will have to be switched to AHCI. Unfortunately, this also means Windows needs to be reconfigured, otherwise it won’t boot anymore.

  1. Click the Start Button and type cmd
  2. Right-click the result and select Run as administrator
  3. Type this command and press ENTER: bcdedit /set {current} safeboot minimal (ALT: bcdedit /set safeboot minimal)
  4. Restart the computer and enter BIOS Setup
  5. Change the SATA Operation mode to AHCI from either IDE or RAID
  6. Save changes and exit Setup and Windows will automatically boot to Safe Mode.
  7. Right-click the Windows Start Menu once more. Choose Command Prompt (Admin).
  8. Type this command and press ENTER: bcdedit /deletevalue {current} safeboot (ALT: bcdedit /deletevalue safeboot)
  9. Reboot once more and Windows will automatically start with AHCI drivers enabled.

6.8.4 32-bit EFI is used

  • No provided install image will boot.
  • Windows is installed in 32-bit mode.
  • Some older Macbooks have this configuration.
  • To install 64-bit Linux (we never encountered an actual 32-bit CPU with this problem!), manually replace the bootloader with a grub standalone. See the Arch Wiki.

6.8.5 I need to turn off Bitlocker

Do not change any BIOS/UEFI settings before disabling BitLocker! You will have to provide the decryption key otherwise, which the user typically has no access to.

  • Launch a command prompt with administrator rights and use manage-bde -off C:, where C: is the drive you want to decrypt.
  • Use the command manage-bde -status to query the decryption status.
  • You will need to wait until decryption is complete, which can take a long time.

6.8.6 Unlock BitLocker Encrypted Devices

If you change any UEFI settings on a BitLocker encrypted device (typically Surface devices), you will be prompted for the BitLocker key on next boot.

Since Surface devices come encrypted out of the box, the user does typically not have that key and Windows will refuse to boot. If this happens, resetting the UEFI settings to factory settings should fix the issue.

Alternatively, you can just enter the correct Bitlocker key. This works only if the user has a Microsoft account linked to the device. You can get the BitLocker key as follows:

  • On another device, google for “BitLocker Recovery Key”. You should find several Microsoft Support or FAQ pages on how to recover the key.
  • Search for a link saying “To get your recovery key, go to BitLocker Recovery Keys” or similar. Go there.
  • Ask the user to sign in using their Microsoft account. The website will then display their recovery key, which can be used to unlock the device.

6.8.7 System will not boot under any circumstance

Some very bad firmwares just refuse to boot GRUB, however you configure it. This “bootloader hack” can be applied in these cases.

  • Try to boot the actual distro that has been installed by “using a device” to boot. Do so by holding shift while clicking on “reboot” in Windows.
  • If that doesn’t work, boot a live system and chroot into the installed system.
  • Once booted or chrooted into the Linux system, become root (sudo su) and go to /boot/efi/EFI/Microsoft/Boot and locate a file named bootmgfw.efi. Rename it to bootmgfw-original.efi.
  • Go to /boot/efi/EFI/grub2 (sometimes also just grub) and locate the file grubx64.efi. Copy it over to /boot/efi/EFI/Microsoft/Boot/. If a file called shimx64.efi exists, copy that one over as well.
  • Find the file grub.cfg in /boot/efi/EFI/grub2 and copy it over to /boot/efi/EFI/Microsoft/Boot/.
  • Go back to /boot/efi/EFI/Microsoft/Boot/. If shimx64.efi exists, rename it to bootmgfw.efi. If it does not exist, rename grubx64.efi to bootmgfw.efi.
  • Now go to /boot/grub/, or /boot/opensuse/ (the exact folder path may vary). Find the file grub.cfg and open it. Find the menuentry block for Windows (usually called “Windows Bootloader (on /dev/sdx)” or similar). Copy the entire block.
  • Uninstall the package os-prober.
  • Now go to /etc/grub.d. If a file with os-prober in its name exists, delete it.
  • Find the file 40-custom.cfg. If it doesn’t exist, create it. Paste the menuentry block you copied earlier in this file.
  • In the text you just pasted, look for bootmgfw.efi and change it to bootmgfw-original.efi.
  • Save the file.
  • Run grub-mkconfig -o /boot/grub/grub.cfg. Make sure the file path matches the path where you originally found the grub.cfg you copied the menuentry from.
  • Reboot and verify that grub now loads properly. Also test whether Windows boots!
VSETH Logo

VSETH

Copyright 2023 VSETH