Manjaro-Documentation-0 8 10 PDF
Manjaro-Documentation-0 8 10 PDF
10
USER GUIDE
Licensed under the Attribution-ShareAlike 4.0 International Licence (the Licence); you may not use this
le 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 specic language governing permissions and limitations under the Licence.
Core Team
Philip Mller Project Leader, Project Management and Coordination,
Mirrors Manager, Packager, Developer, Web Developer
Maintainers
Dan S. Openbox Editions Maintainer
Documentation
Jonathon Fernyhough Editor of the User Guide 0.8.9-0.8.10
Sabras Wiki
Alumni
Carl Duff Community, Documentation and Wiki Management, Script-
ing and Conguration
6 manjaro linux 0.8.10
Acknowledgements
Introduction 11
I Getting Manjaro 13
Downloading Manjaro 15
II Installing Manjaro 29
Getting help 69
Index 95
Introduction
About Manjaro
Features
1: Welcome to Manjaro!
Part I
Getting Manjaro
Downloading Manjaro
Manjaro editions
There are four editions of Manjaro available for download. Three To download Manjaro go to this
web address: http://manjaro.org/
editions of Manjaro come complete with a pre-installed desktop
get-manjaro/
environment and a selection of popular software applications. Any
of these would be a great choice for anyone who wants to try out
Manjaro on a Live-CD without having to install it rst. If you have When you purchase retail software it
the time its worth taking each for a test run to see which you like generally comes on a disc, whether
a CD or a DVD. A Live-CD has
best! a version of the operating system
that will run without needing to be
Xfce The Xfce desktop environment is designed to be lightweight installed. This is a feature of most
while retaining a familiar desktop interface. If youre not sure GNU/Linux and BSD-based operating
systems.
which edition to choose, this one is a good bet. Xfce edition disc
image les start with manjaro-xfce.
suggest you stick with the Xfce version. You can of course change
later, or install other desktop environments too!
There are currently four main community editions: Cinnamon,
GNOME, MATE, and Netbook.
fd99f9328103007b3a04d4a1a826e81769288ae4 manjaro-kde-0.8.8-i686.iso
2b997a76ef23d1ef0a3a819a2ed8bef1f2e9a1b5 manjaro-kde-0.8.8-x86_64.iso
18b7df6f12c2b9d2b35b7716e89d71b91b873805 manjaro-net-0.8.8-i686.iso
80fc756226625d7b23ef909135fca32714d795d2 manjaro-net-0.8.8-x86_64.iso
b2fc1a5107e70f4cea2981ed941df5fc249a11ea manjaro-openbox-0.8.8-i686.iso
b91b8a8d3133342f4cfdb1ba09c28ec20c8492e1 manjaro-openbox-0.8.8-x86_64.iso
590750cc76d11efb47a153f1fcfcd4b6689f055e manjaro-xfce-0.8.8-i686.iso
1b8fcf0d24972f3881c2a331fd202cb0842866aa manjaro-xfce-0.8.8-x86_64.iso
You may have seen there are two checksum les. One ends -sha1sum.txt,
the other ends -md5sum.txt. MD5 and SHA are two types of hashing
algorithms; the sha part of the checksum le name stands for Se-
cure Hash Algorithm. These algorithms are used to generate a hash
code unique to the disc image le. The checksum le itself is just a
text document that contains hash codes that should match the code
generated by the MD5 or SHA-1 algorithm. Copies of the le can be
checked to make sure they are exactly the same - if the le is changed
in any way, either intentionally or by corruption, the code generated
20 manjaro linux 0.8.10
will be different.
Whilst MD5 is commonly used, SHA-1 is newer and more secure
and is beginning to replace MD5. For the purpose of checking the in-
tegrity of the downloaded le MD5 is good enough but SHA-1 is a
better solution. The checking process is the same for both algorithms.
We recommend you use SHA-1. For more about hashing algorithms
Wikipedia has lots of information.5 5
https://en.wikipedia.org/wiki/
Secure_Hash_Algorithm
If the code generated from the disc image matches that contained
in the checksum le, then the disc image le is ne. If the two codes
dont match then it means that the disc image le 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 le manjaro-
0.8.10-sha1sum.txt. Test builds have a slightly different
arrangement. Instead of a single le
with all checksums, each disc image le
Checking in Linux has its own associated checksum le. If
youre running the test build Im sure
you can work it out!
Automatic verication
The program sha1sum can automatically compare the checksum of
the disc image you downloaded against the value in the text le. The
process is very straightforward, but the end result might look a little
worrying!
For this example, I rst open a terminal and change to the direct-
ory where I downloaded the disc image le and checksum le. I use
the command ls to check which les are present:
jonathon@box:~$ cd download
jonathon@box:~/download$ ls
manjaro-0.8.10-sha1sum.txt manjaro-xfce-0.8.10-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 values in the checksum
le:
The next set of lines show the result of the checks. While the rst
few lines look worrying this is to be expected - the program cant
check disc image les that arent there! The second to last line is
the important one. It shows that sha1sum has successfully veried the
disc image I downloaded against the checksum value in the le.
Manual verication
To manually check the integrity of your downloaded le, rst open
the downloaded manjaro-0.8.10-sha1sum.txt checksum le using a
text editor such as Gedit. Once the checksum le has been opened,
and the codes are visible, open up your terminal and change to the
directory where your downloaded disc image is stored.
jonathon@box:~$ cd download
22 manjaro linux 0.8.10
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
0.8.10 disc image which can then be manually compared to the code
contained in the checksum le.
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.6 Another free 6
http://download.cnet.com/
checksum utility which has positive reviews is Raymonds MD5 &
SHA Checksum Utility.7 This is the program we will use in the fol- 7
http://raylin.
wordpress.com/downloads/
lowing example.
md5-sha-1-checksum-utility/
4. Click the button beneath the title Select a disc image to write to
open up your le manager. Locate and double-click the down-
loaded disc image le to load it. Upon automatically returning to
the Image Burning Setup window, note that the disc image le is
now listed as the disc image to write.
5. The blank CD/DVD you inserted should be automatically listed
underneath the title Select a disc to write to. If not, click the but-
ton to select it manually.
6. Click the properties button to open the properties window, and
then click the button beneath the title Burning Speed. We strongly
recommend you select the slowest speed available. Once selected,
click the Close button. We strongly recommend you select the
slowest speed available when burning
7. Click the Burn button to start the burning process. If necessary, to disc in order minimise the possibility
follow any on-screen instructions provided. of corruption during the burning
process.
Its also a good idea to avoid using
any applications which make intensive
Burning to a CD/DVD in Microsoft Windows use of system resources while burning,
and in particular avoid heavy disc
Newer versions of Microsoft Windows (Windows 7 and later) include access. If the burner software cant read
the disc image le quickly enough the
a disc image burner. If you do not have a newer version of Microsoft
burning process can be interrupted.
Windows you will need to download one of the many free disc burn-
ing software utilities.
2. Start Windows Disc Image Burner. For more information about this
program see: http://windows.
3. Click Burn. microsoft.com/en-gb/windows7/
burn-a-cd-or-dvd-from-an-iso-file
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 Win-
provide information about features and screenshots of the applica- dows
tions themselves. For a little more information about each of these
applications, an overview of each is available in the CD/DVD Burn-
ing Article on the TechSupportAlert website.8 Alternative burning 8
http://www.techsupportalert.com/
software may also be found on the Download.com website,9 although best-free-cd-dvd-burning-software.
htm
9
http://download.cnet.com/
26 manjaro linux 0.8.10
you will have to lter the search results to view only free applica-
tions. It will also be worthwhile to take the time to read any reviews
provided for your choice(s).
To take advantage of the faster access times and much quieter nature
of a USB ash drive, there are a number of methods of writing the
disc image le. One of the easiest is to use ImageWriter.
ImageWriter should be available for installation from your distri-
butions Software Center / Software Manager / Package Manager /
repositories. Once Imagewriter has been downloaded and installed, 2: ImageWriter
ensure that your USB ash drive is plugged in before starting the ap- https://en.opensuse.org/
plication. SDB:Live_USB_stick
The process of using ImageWriter is very straightforward:
2. Navigate to where you downloaded the disc image le, and select
it.
3. Ensure that your USB ash drive has been selected from the drop-
down menu.
5. Once it has nished, reboot your system, making sure to select the
USB ash drive as the boot device.
5. Once it has nished, reboot your system, making sure to select the
USB ash drive as the boot device.
Re-partitioning your USB stick as
If for some reason the writing process is unsuccessful the Image- a RAW data type will result in all
data present being destroyed, and will
Writer authors recommend that you use a partitioning tool to re- render it unusable for other purposes
format the USB ash drive as a RAW partition type, then try again. until reformatted back to its original
partition type
Unfortunately this process is outside the scope of this guide.
Part II
Installing Manjaro
Booting the Live environment
When you boot from your installation media (CD/DVD or USB ash
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 conrm and to be taken back to
the boot menu.
2: Language selection
32 manjaro linux 0.8.10
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. 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 up- drivers.
dated by a large community. For older hardware and that with
Intel-based integrated graphics, this is the best choice.
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 (like the thing youre reading now!) and the support channels.
There are also links to the installation programs. Dont worry if you
close the welcome screen: you can load it again, and all the links are 4: Welcome to Manjaro!
also present elsewhere in the menus.
Using the graphical automatic installer
Installation...
...complete!
Log in
For a refresher on partitioning your disk, check out the wiki pages on
partitioning and partitioning scenarios:
Partitioning: http://wiki.manjaro.org/index.php?title=Partitioning_
Overview_and_Existing_Partition_Tables
A two-partition scenario
Partition 2: Home
Swap partition
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 operating
systems will boot with this enabled. You must disable this in your
BIOS before proceeding; if you dont know how to do this please
refer to your computers user manual.
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 is the lack of any option for language or keyboard
layout. However, this is actually not that important! When you run
Thus and choose your language and keyboard layout this will take
effect within the Live environment, along with setting these for the
installed system.
48 manjaro linux 0.8.10
With Manjaro 0.8.10, Thus does an excellent job setting up your sys-
tem. Once you have loaded the Live environment the installation
steps are exactly the same as for a non-UEFI installation. The main
difference is in the partition layout: this is important if you wish to
manually partition the drive to suit your own requirements.
In automatic mode, Thus creates a conservative partition lay-
out that will work on all systems. However, the key extra partition
for compatibility with UEFI systems is a fat32-formatted partition
mounted at /boot/efi - make sure to include this if you partition
manually!
user guide 49
It is possible that you want install Manjaro but keep an existing Win-
dows 8 installation on your computer. This is possible, but a little
more complicated to set up. Its not for the faint-of-heart, and you
should make sure you have a backup of any important documents or
information before proceeding.
The following instructions assume you are using a machine with
UEFI enabled, Secure Boot disabled, and are using drives with a
GUID Partition Table (GPT).
Click Start, and you are done! (though it takes between around two
and ve minutes to complete).
Boot Manjaro Linux ... (default) This chooses the open-source graphics
card drivers.
user guide 51
Boot Manjaro Linux ... (nonfree) This option chooses the proprietary
graphics card drivers from Nvidia or AMD.
If youre not sure which to use, refer back to the earlier section Boot-
ing the Live environment.
Once you are happy with the new partition layout, on the menu go
to Edit, Apply all operations. There will be a conrmation message;
to continue you must click Apply.
The resizing process will take some time. Perhaps another chance
to get a cup of tea! Once it has completed, close GParted and then
run Install Manjaro Linux.
52 manjaro linux 0.8.10
sudo update-grub
Install system
Congure system
Install bootloader
Quit
Welcome to Manjaro
The Manjaro desktop
Once you have logged in you will be presented with the Manjaro
desktop. The Welcome Screen will load automatically and this gives
you some useful links to documentation, ways to get help and sup-
port from the Manjaro community, and some ways you can get in-
volved 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 untick the box Show this dialog on startup. Dont worry: you
can always nd 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
is in the corner of the screen. Go ahead and click on it now! You can also press the Windows or
Super key on your keyboard. Handy!
64 manjaro linux 0.8.10
You can see that the ve 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 ve applications to give an idea
of what awaits you!
4: Add to Favourites
user guide 65
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 difcult to
accomplish with a graphical in-
terface. In this example, I have
listed (ls) the les 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 nding 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
http://forum.manjaro.org/
IRC channels
http://manjaro.org/irc-channel/
Mailing list
http://lists.manjaro.org/listinfo/manjaro-general
Wiki
http://wiki.manjaro.org/index.php?title=Main_Page
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
84 manjaro linux 0.8.10
Octopi
The process of installing new software using Octopi is very similar to
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:
sudo pacman -Su
Its a good idea to check whether the package lists are up-to-date at
the same time:
sudo pacman -Syu
Installing software
Installing a package is equally straightforward. For example, to in-
stall Leafpad: Many software applications depend on
other software packages. Thankfully,
sudo pacman -S leafpad pacman will automatically detect and
install these!
90 manjaro linux 0.8.10
Removing software
To remove a software package you need to know its name, but the
command is straightforward. To remove Leafpad:
sudo pacman -R leafpad
If at a later date you want to remove all orphan packages and con-
guration les for packages that you removed some time ago, the
following command will do it:
sudo pacman -Rns $(pacman -Qtdq)
man pacman
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
machine to use the best for you. Once this command has completed,
you should force a download of the package lists:
2: sudo pacman-mirrors -g
sudo pacman -Syyu
Choosing mirrors
If you would like more control over which mirrors to use, run the
command:
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 3: sudo pacman-mirrors -i
normally best to choose mirrors that are geographically close to you,
so if youre in Canada then Canadian and US servers are generally a
good bet. Of course, youre free to choose whichever you want!
To reset back to an automatic choice, run this command:
sudo pacman-mirrors -g -c all
Switching branches
When you install Manjaro 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:
sudo pacman-mirrors -g -b testing
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:
sudo pacman-mirrors -g -b unstable
92 manjaro linux 0.8.10
If you switch away from the stable branch, but want to move back,
its actually pretty easy:
sudo pacman-mirrors -g -b stable
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:
sudo pacman -Syyuu
More information