Manjaro 17.0.1 User Guide
Manjaro 17.0.1 User Guide
Manjaro 17.0.1 User Guide
USER GUIDE
Licensed under the Attribution-ShareAlike 4.0 International Licence (the Licence); you may not use this
file except in compliance with the License. You may obtain a copy of the Licence at:
https://creativecommons.org/licenses/by-sa/4.0/legalcode
Unless required by applicable law or agreed to in writing, software distributed under the Licence is
distributed on an as is basis, without warranties or conditions of any kind, either express or implied. See
the Licence for the specific language governing permissions and limitations under the Licence.
Core Team
Philip Mller Owner, Project Leader, Project Management and Co-
ordination, Mirrors Manager, Server Manager, Packager, De-
veloper, Web Developer
Artwork
David Linares Designer
Documentation
Jonathon Fernyhough Editor of the User Guide 0.8.9-0.8.13, 15.09-15.12,
Community Management, Cover art of the User Guide
Sabras Wiki
Alumni
Roland Singer Founder, Designer, Developer, Web Developer, Admin-
istrator
Acknowledgements
Introduction 11
I Getting Manjaro 13
Downloading Manjaro 15
II Installing Manjaro 29
Index 133
Introduction
About Manjaro
Features
1: Welcome to Manjaro!
Part I
Getting Manjaro
Downloading Manjaro
Manjaro editions
Xfce edition
360d69fe4fac31ee91fb1e7d7ad4c03321e1ebf1 manjaro-xfce-17.0-stable-x86_64.iso
SHA-1
SHA and others like MD5 are different types of hashing algorithms;
the sha part of the checksum file name stands for Secure Hash Al-
gorithm. These algorithms are used to generate a hash code unique
to the disc image file. The checksum file itself is just a text document
that contains hash codes that should match the code generated by
the MD5 or SHA algorithms. Copies of the file can be checked to
make sure they are exactly the same - if the file is changed in any
way, either intentionally or by corruption, the code generated will be
different.
Whilst MD5 is commonly used, SHA-1 and SHA-256 are newer
and more secure and are beginning to replace MD5. For the pur-
pose of checking the integrity of the downloaded file MD5 is good
enough but SHA-1 is a better solution. The checking process is the
same for both algorithms. For more about hashing algorithms Wiki-
pedia has lots of information.6 6
https://en.wikipedia.org/wiki/
Secure_Hash_Algorithm
20 manjaro linux
If the code generated from the disc image matches that contained
in the checksum file, then the disc image file is fine. If the two codes
dont match then it means that the disc image file has changed in
some way, most likely due to being corrupted. You can think of it like
someone using a password to identify who they are: if they provide
the wrong password, then something is probably wrong.
From this point on well assume you are using the file manjaro-
xfce-17.0-stable-x86_64.iso.sha1.
Checking in Linux
Automatic verification
The program sha1sum can automatically compare the checksum of
the disc image you downloaded against the value in the text file. The
process should be very straightforward!
For this example, I first open a terminal and change to the direct-
ory where I downloaded the disc image file and checksum file. I use
the command ls to check which files are present:
jonathon@box:~$ cd download
jonathon@box:~/download$ ls
manjaro-xfce-17.0-stable-x86_64.iso.sha1 manjaro-xfce-17.0-stable-x86_64.iso
As you can see I have downloaded the 64-bit Xfce edition. Next, I run
the sha1sum program to check against the value in the checksum file:
The line below shows the result of the checks. In this case, it shows
that sha1sum has successfully verified the disc image I downloaded
against the checksum value in the file.
manjaro-xfce-17.0-stable-x86_64.iso: OK
Manual verification
To manually check the integrity of your downloaded file, first open
the downloaded manjaro-xfce-17.0-stable-x86_64.iso.sha1 checksum
file using a text editor such as Gedit. Once the checksum file has
been opened, and the code is visible, open up your terminal and
change to the directory where your downloaded disc image is stored.
For example, if your disc image file is located in a directory named
download, you would first change to that directory:
user guide 21
jonathon@box:~$ cd download
Then you can generate an SHA-1 hash code for the disc image using:
This command generates a hash code for the 64-bit Manjaro Xfce disc
image which can then be manually compared to the code contained
in the checksum file.
Unlike Linux, Microsoft Windows does not have any suitable built-in
tools so you will need to download and install a checksum utility
application. A web search will turn up several examples of free soft-
ware, or you can look on the Download.com website.7 Another free 7
http://download.cnet.com/
checksum utility which has positive reviews is Raymonds MD5
& SHA Checksum Utility.8 This is the program we will use in the 8
https://raylin.
wordpress.com/downloads/
following example.
md5-sha-1-checksum-utility/
Many people routinely use a DVD rather than a CD even for the
smallest disc image files. Not only is a DVD faster to burn but they
allow higher data access rates so the Live-CD loads faster and the
installation completes sooner.
However, with the increasing capacity and decreasing cost of USB
flash media this presents an even more attractive method than the If your system will boot from a USB
traditional burning process; it is far faster and more flexible than device, and you have one of sufficient
capacity that you can erase, we recom-
using optical media. Both CD/DVD burning and USB flash media mend the use of a USB flash drive over
installation methods are covered in this guide. traditional CD/DVD media.
24 manjaro linux
4. Click the button beneath the title Select a disc image to write to
open up your file manager. Locate and double-click the down-
loaded disc image file to load it. Upon automatically returning to
the Image Burning Setup window, note that the disc image file is
now listed as the disc image to write.
4. Click Burn.
The burning process for each of these applications is similar, with Table 2: Third-party disc burn-
small differences in user interface. The websites listed above will ing software for Microsoft
Windows
26 manjaro linux
To take advantage of the faster access times and much quieter nature
of a USB flash drive, there are a number of methods of writing the
disc image file. One of the easiest is to use SUSE Studio Image-
writer.
SUSE Studio Imagewriter should be available for installation from
your distributions Software Center / Software Manager / Pack-
age Manager / repositories. Once SUSE Studio Imagewriter has 2: SUSE Studio Imagewriter
been downloaded and installed, ensure that your USB flash drive https://en.opensuse.org/
is plugged in before starting the application. SDB:Live_USB_stick
The process of using SUSE Studio Imagewriter is very straightfor-
ward:
2. Navigate to where you downloaded the disc image file, and select
it.
3. Ensure that your USB flash drive has been selected from the drop-
down menu.
5. Once it has finished, reboot your system, making sure to select the
USB flash drive as the boot device in the BIOS menu (or its UEFI
equivalent).
1. Connect the USB flash drive to your PC, open a terminal and cd to
where you downloaded the disc image.
To view how the writing process progresses, use the option status=progress:
sudo dd if=manjaro-xfce-17.0-stable-x86_64.iso of=/dev/sdc
bs=4M status=progress
4. Once completed reboot your system and boot from the USB drive
by selecting it as the boot device in the BIOS menu (or its UEFI
equivalent).
Click Start, and you are done (though it takes between around two
and five minutes to complete)!
3: Rufus with recommended
settings
Part II
Installing Manjaro
Booting the Live environment
When you boot from your installation media (CD/DVD or USB flash
drive) you should be presented with the Manjaro boot screen. This
screen provides several options to help get the best experience from
the Live environment.
It is possible at this stage to set your preferred language and key-
board layout before using Manjaro. This means that you will be able
to use and install Manjaro in your native language straight away.
1: Boot menu
Setting your language and keyboard layout
First, set your preferred language by pressing the<F2> key. The op-
tions available can be highlighted for selection by using the arrow
keys on your keyboard. In this instance, English (UK) has been high-
lighted for the user.
Once selected, press <Enter> to confirm and to be taken back to
the boot menu.
2: Language selection
32 manjaro linux
There are two main sets of drivers that can be used by Manjaro: Free
and non-Free. The differences are not minor, and your choice can
depend on your computer hardware. Some of the drivers are used for
display. The one associated with your graphics card will be selected
in both of these categories. If in doubt, choose Free drivers. If you
want to play games, choose non-Free
Free drivers are open-source, like Manjaro itself, written and updated drivers.
To start Manjaro with Free drivers, choose Start Manjaro Linux from
the boot menu.
To start Manjaro with non-Free drivers, choose Start (non-free
drivers) from the boot menu. 3: Start Manjaro Linux
Welcome to Manjaro
Once you select Start, Manjaro will boot up. You may see a lot of
scrolling text - dont worry, this shows the system is working! After
a little while, assuming your hardware is compatible, you will be
presented with a Live desktop environment and a nice friendly wel-
come screen.
The welcome screen gives some links to common tasks, document-
ation and the support channels. There are also links to the install-
ation programs. Dont worry if you close the welcome screen: you
can load it again, and all the links are also present elsewhere in the 4: Welcome to Manjaro!
menus.
Some useful definitions
If you sometimes feel like saying What do these words mean, is he just
making them up?, this chapter is for you. Installing a new operating
system may force you to face some concepts you have barely even
heard of before, such as partitions and file systems. This can be a bit
overwhelming at first, but do not despair, as this short chapter is
here to help you! Most of these terms will only be important if you
choose to manually install Manjaro. In the three different assisted
installation options, the installer will do almost all the work for you.
First of all, installing a new operating system will require you (or
the installer) to perform some disc management tasks in order to free
some space on your drive to be able to install it. You will most likely
encounter the following terms.
Feel free to come back to this short list if you ever need it! Some links
are scattered throughout the guide for quick access.
Assisted installation on a BIOS system
You can also choose to encrypt your Manjaro partition. That way,
anyone trying to access to the data it contains will have to enter a
password of your choosing. The Boot loader location menu allows
you to choose whether or not to install a boot loader, and if so where
to install it. A boot loader is a program which enables you to choose
which operating system to boot when you turn on your computer.
If you are unsure what to do, we recommend keeping the default
choice.
42 manjaro linux
Installation...
... complete!
The last option is the one that gives you the most control. You will
get the chance to adjust yourself the partition scheme of your hard
drive using the built-in partition manager and make it exactly the
way you want it.
Create partitions
Apply changes
UEFI is the commonly agreed on name for both the EFI & UEFI stand-
ards which merged. It does not include the old EFI v1, or Apples own
non-standard version of EFI.
The most important step is to ensure that your machine does not
have Secure Boot enabled. Only a very limited number of operat-
ing systems will boot with this enabled. You must disable Secure
Boot in your BIOS before proceeding; if you dont know how to do
this please refer to your computers user manual, as it differs for all
computers.
Once you have booted the system from the Live CD/USB you will
be presented with the Manjaro boot selection screen. It has two main
options for the drivers it will use (either Free or non-Free). The main
difference compared to the case with a BIOS system is the lack of any
option for language or keyboard layout. This is actually not that big
of a problem, since these can be set up in the live environment and
in the Calamares installer, which will make them permanent on the
installed system.
62 manjaro linux
Some more steps are required if you want the Live environment to
be in another language than English on a UEFI system. The keyboard
layout can be set in the Calamares installer as shown earlier. Please
note that these steps are not required for Manjaro to be installed
in another language. They are only useful if you want the Live
environment, before installing Manjaro, to be in another language.
The key difference in the way the partitions are arranged compared
to the case with BIOS is that a small partition of a few hundred MB
must be created to house some of the files used when booting the
system. This partition must use the fat32 file system. Luckily, in all
assisted installation options, Calamares handles the creation of this
partition if it does not already exist and writes the necessary files to
it. If the partition already exists, it is detected and used to write the
files.
Assisted installation
The installation using the three assisted installation options does not
change much from the case with a BIOS. Calamares takes care of the
differences for you. For specific instructions about dual-booting with
Windows, see chapter Dual-booting with Microsoft Windows 10.
Erase disk
Install alongside
Replace a partition
The manual installation option is the one that changes the most if
you are using a UEFI system. The following steps will walk you
through the process of creating a partition scheme suitable for your
system in three different scenarios. The first one (Creating partitions
from scratch) will show you how to create your partition scheme
from within Calamares without using existing partitions. The second
one (Using GParted to create partitions beforehand) will show
you how to create the partitions with GParted. Finally, the third one
(Using an already existing EFI partition ) will show you how to use
previously created partitions during the installation, including a EFI
partition used by another operating system. These partitions can
have been previously created with GParted.
This scenario will assume that you do not wish to use a single exist-
ing partition. We will thus start with a completely empty hard drive.
This will also be the case if you are using a brand new drive or are
using a virtual machine.
The creation of the partition table and partitions shown above can
also be handled by GParted. The following steps will guide you
through the process.
Apply changes
82 manjaro linux
Click Start, and you are done! (though it takes between around two
and five minutes to complete). 1: Rufus with recommended
Once you are done, restart your computer and boot on the USB settings
key as was explained earlier in chapter Assisted installation on a
UEFI system.
88 manjaro linux
Assisted installation
This can also be done in the manual partitioning option. The steps
below are very similar to the ones presented in other sections such as
Manual installation on a BIOS system and Creating partitions from
scratch.
Sometimes the boot loader GRUB2 does not detect an existing Mi-
crosoft Windows installation when installing. This means that only
Manjaro Linux will appear in the list of installed operating systems
when you boot the machine.
To solve this problem, run the command:
sudo update-grub
Assisted installation
Manual installation
Welcome to Manjaro
The Manjaro desktop
Once you have logged in you will be presented with the Manjaro
desktop. The Manjaro Hello welcome screen will load automatically
and this gives you some useful links to documentation, ways to get
help and support from the Manjaro community, and some ways you
can get involved with the project. Remember that Manjaro is free
and open-source software: it relies on contributions from its user and
developer community!
If you dont want the welcome screen to load each time you log in,
just set the Launch at start option off at the bottom right of the win-
dow. Dont worry: you can always find it again in the applications
menu.
The applications menu is the easiest way of starting the software
programs that are installed on your Manjaro system. The icon for this
102 manjaro linux
You can see that the five main software applications have an item
in the Favourites menu. This allows rapid access to software you
most often use. To add or remove an item from the Favourites menu,
just right-click on it and select the option you want.
For now, lets look in turn at these five applications to give an idea
of what awaits you!
3: Add to Favourites
Terminal Emulator
5: Terminal Emulator, or
terminal, allows you to per-
form text-based commands.
Although it initially seems
unfriendly it is incredibly
powerful and allows access to
commands that are difficult to
accomplish with a graphical in-
terface. In this example, I have
listed (ls) the files in my home
directory.
Learning how to use the
terminal is not needed
for running Manjaro. Its
highly recommended, how-
ever; check out sites like
http://linuxcommand.org/
File Manager !
Web Browser
Mail Reader
Add/Remove Software
There are a variety of ways of getting help and support about Man-
jaro, as well as finding out more about the project. You can just
browse, or register if you want to get involved!
Remember that Manjaro is run by its community. Without a com-
munity there would be no Manjaro!
Discussion forum
https://forum.manjaro.org/
IRC channels
https://manjaro.org/irc-channel/
3: Join #manjaro on
irc.freenode.net, whether via
a web or desktop client, and
youll find a very nice bunch of
people ready to chat! To talk on
the IRC channel you will have
to connect first. Hexchat, which
enables you to do so, comes
installed in the Xfce edition.
Mailing list
https://lists.manjaro.org/listinfo/manjaro-general
Wiki
https://wiki.manjaro.org/
Changing settings
While the Manjaro desktop comes with a set of defaults that should
work well for most people, you might want to change things like the
desktop wallpaper and colour scheme, or perhaps how your laptop
touchpad behaves.
Adding a printer
Updating software
Pamac
Octopi
Octopi is an alternative software manager for Manjaro. It is installed
with the Openbox and KDE editions as it is based on the Qt toolset.
It also has a very funky icon!
Pamac
Octopi
The process of installing new software using Octopi is very similar to
the one using Pamac.
Using Pacman
This will only download the package lists if there has been a change.
Occasionally you may want to force the package lists to be down-
loaded. To do this, type:
sudo pacman -Syy
Updating software
Pacman will allow you to perform an update of software already
installed with the command:
sudo pacman -Su
Its a good idea to check whether the package lists are up-to-date at
the same time. To do so, type:
sudo pacman -Syu
Installing software
Installing a package is equally straightforward. For example, to in-
stall Leafpad, type: Many software applications depend on
other software packages. Thankfully,
sudo pacman -S leafpad Pacman will automatically detect and
install these!
user guide 127
Removing software
To remove a software package you need to know its name, but the
command is straightforward. To remove Leafpad, type:
sudo pacman -R leafpad
If at a later date you want to remove all orphan packages and con-
figuration files for packages that you removed some time ago, the
following command will do it:
sudo pacman -Rns $(pacman -Qtdq)
To exit, press q.
Manjaro will regularly trigger an update of the mirror list, but some-
times its useful to do this manually.
To update the mirror list use the following command:
sudo pacman-mirrors -g
This will test the speed of all currently available mirrors and set your 2: sudo pacman-mirrors -g
machine to use the best for you. Once this command has completed,
you should force a download of the package lists with the command:
Choosing mirrors
If you would like more control over which mirrors to use, run the
command:
sudo pacman-mirrors -i
3: sudo pacman-mirrors -i
This will allow you to select which mirror, or mirrors, to try when
checking for software updates and downloading new packages. Its
normally best to choose mirrors that are geographically close to you,
so if youre in Canada then servers from Canada and the US are
generally a good bet. Of course, youre free to choose whichever you
want!
To reset back to an automatic choice, run this command:
Mirrors can also be refreshed from within Pamac. There you can
select the country from which to choose the mirrors. Choosing your
country or one close to yours is generally a good idea.
user guide 129
Switching branches
When you install Manjaro, unless you specifically installed a preview
version, you will be using the stable branch. This set of packages has
the most testing and so is the best for most users. However, you may
want to help test packages before they move to the stable repository.
To do this, you can switch to the testing branch with the command:
The testing repository has packages that have been checked by the
Manjaro development team to make sure they work correctly. How-
ever, the amount of testing done is much smaller than for the stable
branch - but this is how they get tested!
If you want to live on the bleeding edge, you can switch to the
unstable branch. This is normally used by the Manjaro developers.
Packages from the unstable branch can cause problems, so this is not
something to do lightly. If you ever decide to try it out, the command
is:
If you switch away from the stable branch, but want to move back,
its actually pretty easy. You can switch back to the stable branch in
the same way you left it, with the command:
This will leave the newer packages on your system and these will be
replaced as the stable branch catches up. However, if you want to
force a downgrade of packages back to the stable version, use:
This means Pacman thinks it is already running. If it is, and you try
to force an installation or removal of software, the package database
can be left in an inconsistent state. This would be bad. So, the first
thing to check is whether an installer is running. One of the easiest
ways to check is to run a terminal command:
ps x | grep pacman
This might look complicated, but its just two small commands joined
(piped) together. First,
ps x
searches for the text pacman. The pipe, |, takes the output from
the first and feeds it to the second. To check whether another pro-
gram is running you can just change the text pacman to something
else:
ps x | grep pamac
ps x | grep octopi
Once you are sure an installer is not running, you can delete Pac-
mans lock file with the command:
sudo rm /var/lib/pacman/db.lck
Ensures no packages are left out of line with the current repository
state.
132 manjaro linux
More information