Difference between revisions of "En:FAQ"

From Sabayon Wiki
Jump to: navigation, search
(After installation)
(After installation)
Line 256: Line 256:
=='''After installation'''==
=='''After installation'''==
===What is Entropy or Equo?===
[[Entropy]] is the binary package manager of Sabayon Linux. To install binary packages you use either the command line client [[Equo]] or the newest Graphical GUI [[Rigo]].
A binary package is a file package containing the already-compiled files to install instead of having to compile the source code. Equo, and [[rigo]] handle these files.
===I just installed it, what do I do first?===
===I just installed it, what do I do first?===

Revision as of 23:53, 9 February 2013

i18n: ca en es it


General Questions regarding Sabayon Linux

What is Sabayon Linux

Sabayon Linux is based on the source-based distribution named Gentoo Linux http://gentoo.org. Gentoo is a particularly customizable distribution that we have used as our base to create a pre-configured distribution. If you have other questions on Gentoo and its philosophy, I request you visit their website. In particular, Sabayon is based on Gentoo's testing branch. Gentoo's testing branch is about on par with Debian's Sid (unstable branch) releases. Though based on the bleeding edge, you will find Sabayon is quite stable and perhaps more cutting edge. Both Sabayon and Gentoo are on rolling release cycle, but Sabayon will have release snapshots.

What is Sabayon Linux based on?

Sabayon Linux is based on, and emanates substantially from, Gentoo GNU/Linux(Gentoo testing). Gentoo Linux is one of the most popular source-based Linux distributions. As Ubuntu uses some of the packages from Debian, so Sabayon recieves its packages from Gentoo. In particular, Sabayon is based on Gentoo's testing branch. Gentoo's testing branch is about on par with Debian's Sid (unstable branch) releases. Though based on the bleeding edge, you will find Sabayon is quite stable and perhaps more cutting edge. Both Sabayon and Gentoo are on rolling release cycle, but Sabayon will have release snapshots.

Sabayon when using the package manager Entropy is binary based. (currently Sabayon has about 10,000 packages in Entropy)

Sabayon is, when using the package manager "Portage" source based. (the Gentoo repo is quite huge)

What is the difference between source-based and binary based distribution?

Most distros, such as Ubuntu, Debian, Red Hat, Fedora and SUSE, install binary packages. Simply put, a binary package is the pre-compiled program, compiled on another computer and made available for download and installation on other computers.

A source-based distro is a distro that compiles its programs from source code on the target computer at the time of installation, rather than relying on others to compile and package them. Source-based distros generally also have in their repositories some binary (pre-compiled) packages; these will be the large programs such as OpenOffice, the reason being that the compilation of these can take several hours.


  • Overlay: We have our own Portage overlay for ebuilds. Ebuilds are script files that contain instructions for the Portage package manager on how to install the package from its source code.
  • Performance: We have modified the Portage make.conf file in order to ensure that our distribution will run at higher speed on newer computers and as fast as possible on older computers.
  • Variability: Again, we have modified make.conf in order to cater for a wide spectrum of hardware using the x86 and amd64 (x86_64) processor architectures.
  • Entropy: We have a binary manager that can be used as the one and unique package manager. It functions also with Portage so that you can use them both if you are an experienced user. The Entropy binary packages are ready-built and can be installed immediately without the need to compile anything from the source code.
  • The main branch of Gentoo is considered Gentoo stable. Sabayon is based on Gentoo's testing branch.
  • Sabayon has different versions ready for quick and pain free installation. The Gentoo installation is done from the ground up, relying on you to make all the configuration choices.
  • Gentoo has use flags. Sabayon will ignore use flags when using Entropy, but will apply the use flags when using portage.

Why choose Sabayon Linux ?

1. Variety

Sabayon has multiple editions to choose from. From a variety of desktops to a variety of packages and installations that can enjoyable to new linux users to the power users that prefer a high level of customization.

2. Sabayon is a rolling release.

Once installed you should not need to reinstall updated versions as you can use the updates tools on your desktop. This also allows you to have the latest and greatest packages available to you at all times.

3. The Anaconda installer.

The Anaconda installer in Sabayon greatly simplifies installation including disk partition setup and disk encryption if you desire.

4. Choice of package managers and repo's.

Sabayon's package manager Entropy is binary and currently contains about 10,000 packages. Gentoo's package manager Portage is source based and quite huge.

5. Support

Sabayon is highly maintained. You can find help through our forums, live help, and ever growing wiki.

6. Look and feel.

Sabayon is generally considered 1 of the more attractive Linux distro's to the eye. From the installer, to the desktops, and down to even the terminal which has a color scheme applied to make any work on the command line pleasing to the eye and easy to understand.

7. Using Sabayon helps to save the world

Test results have shown using Sabayon Linux improves the economy; helps reduce global warming; is generally good for the environment; promotes world peace; and helps to fight off alien invasive species from other galaxies. It is also shown to be helpful in improving the health of you sense of humor, which is important to keep from bashing your head on the key board during difficult moments. (Test results may vary as number 7 is considered an attempt at humor)

Should I use Sabayon as a source-based or binary based distribution?

Sabayon Linux has two package managers: Entropy (binary packages) and Portage (source packages). As you can install binary packages instead of source code-based packages, Sabayon Linux offers users a choice and the best of both worlds. The binary packages in the Entropy repository have been built by using the Portage package manager and then packaged using Entropy packaging tools on that computer. The binary packages are stored in the Entropy repository and you install them on your computer by using either the Equo command line client or the Sulfur GUI client. As the release time and date of packages are a little different between the 2 package managers it is recommended to use one package manager consistantly to avoid conflicts.

Generally, using Entropy with binary packages is recommended to new users and those who just want everything to work easily.

Portage(source based) is recommended for more advanced users who wish to customize thier installation to a higher degree.

There are two main advantages to source-based distributions. Firstly, source-based distros often have the newest software before binary distros do. This is due mostly to the fact that, rather than having to compile a package and then test it on different machines, all that is required in something like Sabayon Linux is a file telling it where to find the source code and how to compile it. Secondly, undoubtedly a program will eventually have a feature you don't need, and will just take up space or slow down the program. In a binary distro, you're stuck with this feature. In a source-based distro you have the option of removing unwanted features at the time of compilation (assuming you are using Portage rather than Entropy).

System Requirements

  • Live Environment - No 3D Desktop:
    • i686 Processor
    • at least 512 MB of RAM (1 GB suggested)
    • a 2D graphics card
    • a DDC capable Monitor
    • mouse and keyboard
  • Live Environment - 3D Desktop:
    • i686 Processor (starting from AMD K6 and Intel Pentium II)
    • at least 512 MB of RAM (1 GB suggested)
    • an OpenGL capable 3D graphics card (mostly NVIDIA, ATI, Intel, VIA)
    • a DDC capable Monitor
    • mouse and keyboard
  • Installation:
Please note that the below Requirements can be a bit too low for some Desktop Environments.

A full KDE Desktop for example, CAN run with only 1 GB RAM, but you will most likely run out of memory during a session.

Especially when running programs, such as firefox or thunderbird. Please keep that in mind.
    • i686 Processor
    • at least 512 MB of RAM (1 GB suggested for decent eyecandy effects)
    • an OpenGL capable 3D graphics card (mostly NVIDIA, ATI, Intel, VIA)
    • 20 GB of free space, that is bare minimum DVD Install. 30+ GB is highly recommended.
    • 8 GB of free space for miniCD. 10+ GB is recommended
    • Internet connection (not mandatory but highly suggested)
    • a DDC capable Monitor
    • mouse and keyboard

What Editions are available in Sabayon Linux?

Sabayon is all about choice. You have many flavors to choose from.

You can download them from the mirrors, here:

The following choices are the main releases available in 32Bit (x86) or 64Bit (amd64):

"amd64" is also suitable for Intel based 64bit Processors
1. KDE
2. Gnome
5. XFCE 
6. Enlightenment

All of the above mentioned Desktop Environments are fully featured.

7. CoreCDX
CoreCDX is a minimal install for those wishing to configure the system more to their liking,
(for more advanced users) in 32bit or 64bit., and uses the Fluxbox Window Manager.

How can i contribute to, or support Sabayon Linux

There are several ways to contribute to Sabayon Linux.

  • The Sabayon foundation is always looking for funds.

For more information, see: http://www.sabayon.org/donate

  • Translations.

We are always looking for translators. The Wiki, as well as Translating sabayon to your native language.

You can subscribe to our wonderfull Wiki, and translate the articles in your own Language., or, write your own Articles.

Share your knowledge.

If you want to translate Sabayon into your own language, please see:

En:HOWTO: Translate Sabayon

  • if you want to translate the Wiki articles into your own language, please see:

En:Translations and Editing_Guidelines

  • Subscribe to our Forum

Help out others with problems. perhaps problems you've had once too, and know the answer to the solution.


  • Join us on Facebook or Google+

There are lots of Discussions going on on facebook and Google+. Want to help out, or participate? https://www.facebook.com/groups/36125411841/


  • setup more download mirrors

We need more mirrors!

Check out this link to learn more about what it takes to mirror the Sabayon Linux project. http://wiki.sabayon.org/index.php?title=Mirroring_Sabayon

The liveCD/DVD

burning / checking the .iso image

One of the most common problems with burning a Linux install CD/DVD is that people sometimes don't understand that an iso image file is not a normal file. You cannot just burn the iso to disc to and expect it to work. I repeat: you cannot simply put the iso file on a blank disk and expect it to work. In order to properly make a CD or DVD out of an iso image, you need special software. Instructions for Nero and Isorecorder are included; for other programs, see the manual for the software, or just give one of these a shot.

With Nero you just select file and burn image, then select the .iso file you want to burn. The software handles the rest.

If you're looking for a good, alternative freeware solution, you can download a free image burner.

isorecorder [1] Simply download and install the correct version for your version of windows, then right click on the .iso and tell it to burn.

checking the integrity of the burned disc

Many people know they can check if a downloaded ISO file is OK by comparing the md5sum of the ISO file against the md5sum posted on the SL mirrors. For example:

# md5sum -c SabayonLinux-x86_64-3.4f.iso.md5
SabayonLinux-x86_64-3.4f.iso: OK

cf. the contents of ftp://bo.mirror.garr.it/mirrors/sabayonlinux/SabayonLinux-x86_64-3.4f.iso.md5 which are: 645600788920443b372baae3544acffa SabayonLinux-x86_64-3.4f.iso

so the ISO I downloaded was good.

Remember - verify the MD5 sum for the version of Sabayon that you downloaded - they are all different. The MD5s can be found on the mirrors listed at: http://www.sabayonlinux.org/mirrors

But a different method is needed to verify the integrity of the LiveDVD/CD itself. You should select the verify written data checkbox in K3b before burning the DVD/CD, but if you forgot or still have doubts then the following method can be used to check the integrity of the burnt LiveDVD/CD:

If you only have Windows installed on your HDD, apparently you can use a Windows shareware application, see the following Web page for details: http://www.mepis.org/docs/en/index.php?title=Checking_the_integrity_of_a_Live_CD


1. I have not checked if the method for Windows on the above-mentioned Web page actually works, so use it at your own risk.

Under Linux:

Insert the LiveDVD into the optical drive, let the disc spin up and then enter the following three commands:

md5sum /dev/cdrom | awk '{print $1}' > md5a.txt
md5sum ~/Sabayon_Linux_8_amd64_K.iso | awk '{print $1}' > md5b.txt
diff -qs md5a.txt md5b.txt

(Obviously change the path and/or the ISO file name to match your circumstances.)

If you get an error message while the md5sum is reading the disc, there must be something wrong either with the burn or with the optical drive itself.

If you get the message "Files md5a.txt and md5b.txt differ" then the burn was bad.

If you get the message "Files md5a.txt and md5b.txt are identical" then the burn was good.

Passwords on live CD/DVD

  • The root password:

no password is required: just press the Enter key.

  • The sabayonuser password:

no password is required: just press the Enter key.

  • For older releases (version 6 and earlier) the password for Root is "root" (without the quotes) and the password for Sabayonuser is "sabayonuser" (without the quotes).

The Booting process

The boot process of the liveCD/DVD should be pretty straight forwarded, just as many other Linux Distrtibutions.

However, you could get into problems, when having hardware that isn't supported by default, for example.

Or having old hardware that the current drivers don't support.

When having a old NVidia card, and you've downloaded the latest ISO, chances are that it will not start the Window Manager/Desktop Environment, but rather present you with a black screen.

There is nothing wrong with the ISO, it is because "nvidia-drivers-304.64" or higher is installed by default.

You can bypass that by hitting ctrl-alt-f1, remove the nvidia-drivers, (nouveau is installed too), and restart xdm., as explained below:

Removing latest nvidia-drivers:

    # Press the "CTRL-ALT-F1" key combination.

"#" is just indicated that you have to be root, so do not include that with the actual commands...

# su
# equo remove nvidia-drivers --ask

Check that "x11-drivers/nvidia-drivers" got removed., nothing else... and confirm with "yes"

Restart XDM:

# /etc/init.d/xdm restart

For a overall view of which cards support what driver., please see: http://www.nvidia.com/object/IO_32667.html

If you wish to be guided through the boot process and the several options it offers, we have a visual walkthrough.

Please see: Visual_Tour:_Boot-menu_Sabayon_LiveCD/DVD

Workarounds for problematic Hardware, during the boot process are discussed here:


cheatcodes for ATI and nVidia


noddc res=1024x768 refresh=60 opengl=ati


noddc res=1024x768 refresh=60 opengl=nvidia

To use the cheatcodes, hit F5 on the boot up screen of the livecd/dvd and add one of the lines above pending on your hardware

see: Visual_Tour:_Boot-menu_Sabayon_LiveCD/DVD

When you need to edit xorg.conf, or have to create it for special reasons, the following visual tour will show you how to edit Xorg.conf:


After installation

What is Entropy or Equo?

Entropy is the binary package manager of Sabayon Linux. To install binary packages you use either the command line client Equo or the newest Graphical GUI Rigo.

A binary package is a file package containing the already-compiled files to install instead of having to compile the source code. Equo, and rigo handle these files.

I just installed it, what do I do first?

This question has always amazed me. Who says there is anything to do? How about just using the operating system and getting familiar with it? Take some time and read the documentation. If you insist on having to do something then emerge --sync && layman -S to update your Portage package list, or, if using Entropy, see Fresh Install

The GUI for managing packages

rigo is the GUI for the Entropy package manager.

emerge and layman are Portage commands, Portage is not our own package manager but is available to advanced users. Any steps using these commands can be safely ignored

There are GUIs for the Portage package manager, but they are no substitute for using emerge on the command line.

  • Portato is a GUI for Portage that we recommend as it is the most actively developed. Home Page

Personally if you have to rely on a GUI, then try to just use it as a browser of Portage, but still use the command line to install your packages. You will save yourself a lot of headaches. Search and gather your information needed with the GUI then open up Konsole or Terminal and install using the emerge command.

How do I update/install packages?

There are 2 package managers, Entropy and Portage. It is highly recommended that you choose and only use 1 package manager. Conflicts can arise from mixing both package managers. Please read the Entropy page. Entropy is the package manager specially developed for Sabayon Linux. It has a command line interface (Equo) and a GUI interface (Sulfur). Equo commands and Sulfur GUI are Entropy and recommended for newer users of Sabayon Linux. Advanced users of Sabayon Linux may wish to use Portage, the package manager developed for Gentoo Linux, on which Sabayon Linux is based. For information on Portage, please read HOWTO: The Complete Portage Guide.

How do I install several packages?

For Entropy:

# equo install foo foo foo foo foo

For Portage:

# emerge foo foo foo foo foo

The package manager will install each package one after another. Replace foo with actual package name.

How do I search for a package?

  • For Entropy:
# equo search foo

or use the rigo GUI, or use the Sabayon Linux Web site's Entropy package search page.

  • For Portage:
# emerge -s foo

or use a GUI such as Portato.

Using EIX

  • For Portage:

I highly recommend using eix. It's the best tool you can have at your hands for searching. It is a command line tool, but it is very powerful and will tell you lots of information.

# emerge eix && eix-update
# eix foo

You can use eix in Entropy too:

# equo install eix && eix-update
# eix foo

Example output of eix gedit:

 [I] app-editors/gedit
     Available versions:  2.18.2-r1 2.20.3 (~)2.20.4 {acl debug doc python spell xattr}
     Installed versions:  2.20.4(07:05:31 AM 12/29/2007)(python -debug -doc -spell -xattr)
     Homepage:            http://www.gnome.org/
     Description:         A text editor for the GNOME desktop

Eix has the ability to search Portage and all overlays. Simply edit the /etc/eix-sync.conf file and just add * to it

# echo '*' >> /etc/eix-sync.conf

Then do:

# eix-remote update

Now when you search, it will tell where and what overlay a package is in if it is not in the Portage main tree. This will widen your abilities to find packages, as overlays contain a lot of ebuilds too.


Can I emerge 2 packages at same time in Portage?

Yes you can, but it can and will bog your system down. It's not really recommended.

How do I update everything at once?

For Entropy:

# equo update
# equo upgrade
# equo conf update

See the Sabayon Wiki article Entropy for details.

emerge and layman are Portage commands. Portage is not our package manager but is available to advanced users. Any steps using these commands can be safely ignored

If you are new to this distro and have no understanding of Portage, we do not recommend this until you get to know how this distro works. This is one of the fastest ways to destroy your system. This distro is not like the other distros that have the big easy button update. For your information though, 'world update' is what Gentoo calls updating your entire system. It looks at your 'world file' and compares it to Portage and then proceeds to update all packages. Following is how:

# emerge -- sync && layman -S
# emerge -ua world

You've been warned. When you come yelling because your system won't boot, don't expect sympathy.

N.B. The term 'world' is not used in Entropy.

How do I uninstall a package?

  • For Entropy:
# equo remove foo

Note - this can remove dependencies.

  • For Portage:
 # emerge -C foo

Note - this will not remove the dependencies. You will need to run depclean for that. I stress great caution with depclean, as it means what it says.

How do I find out which packages depend on a certain package?

# equery depends foo

It will tell you all files depending on that package. See using gentoolkit for more information and commands.

I keep getting !!! ARCH is not set... Are you missing the 'etc/make.profile' symlink?

In Konsole/Terminal use the su command to become the root user and then:

  • Run the following command: eselect profile list
  • Look for something like: default-linux/x86/2007.0/desktop and note the number in front of it.
  • Then do: eselect profile set # <--replace the # with the number. In my case it would be eselect profile set 6

Now you should be good to go again.

Do I have to download the LiveCD/DVD every time to upgrade?

No, Sabayon is a rolling release. However in some cases upgrading via live DVD may prove more time efficent.

Entropy: The equo command makes upgrading easy - see Entropy.

Portage: Portage is recommended for advanced users that prefer a higher degree of customization. That being said, Gentoo documentation is quite extensive and helpful for those wanting to dive into it.

Always backup your files before doing anything. My personal opinion: backup, fresh install, restore backup.

How do I get the Desktop Cube thing working?

The desktop cube and 3D graphics do not work after I installed Sabayon Linux to the hard disk, but do work when I'm using the LiveCD/DVD.

Well, in theory what you see when you run the LiveCD/DVD is what you get when you install Sabayon Linux. So if the 3D desktop was working with the LiveCD/DVD then it should work when you boot your new installation. Well, we know all about theories; it doesn't work for everyone. You can either search in the Sabayon Linux Forums and the Sabayon Wiki for help on how to get the 3D desktop working with your particular model of graphics card, or you can ask in IRC #sabayon.

First thing you need to do: make sure the md5sum is good after you downloaded the .iso file, I can't stress that enough. Make sure you have burnt the CD/DVD as slowly as possible, and enable Burn Verify in your burning application.

You will be asked those two questions every time, so please do this so we don't have to waste bandwidth re-asking. It may seem petty to you to check the md5sum but, without knowing you're starting out with a good ISO file, it's pointless to continue. We can spend weeks troubleshooting and if your md5sum was bad, we just waste a lot of time and it causes a lot of frustration. With a bad md5sum you can still get a bootable working desktop, but may have issues elsewhere. So keep in mind, just because it boots, doesn't mean the ISO file is good. How do I check the md5sum and disk you ask? Well, luckily for you: HOWTO: Checking the integrity of a LiveCD or LiveDVD.

OK, so you made sure the md5sum was good and you burnt the disk at a nice slow speed with Burn Verify enabled. Now we can start looking at other things. Do you have the correct video driver and the latest version of it? That will be the first thing to know.

NVIDIA card owners, the following link will save you hours of frustration. Yes, certain cards require certain drivers: http://en.gentoo-wiki.com/wiki/Nvidia. If you do not know or understand what is 'masking' then please read more (Portage users, see http://dev.gentoo.org/~dang/masked.txt. Entropy users, see Entropy#Masking_and_Unmasking_Packages_in_Entropy.

Our Wiki also has a HowTo get NVIDIA and ATI cards working too, so use the relevant information: HOWTO: Get Ati or Nvidia Video Cards working in Sabayon. Also search the Sabayon Linux Forums for posts mentioning your card manufacturer and model.

The above method will work for most people, but you will find that maybe it didn't work for you. Why? I don't know. A little bit of research into /etc/X11/xorg.conf can usually resolve the remaining few that have problems. The following link is full of information for AIGLX: http://en.gentoo-wiki.com/wiki/AIGLX/Troubleshooting. Again, only use the information that is relevant. You will want to pay attention to the xorg.conf settings shown on that page and compare it to your xorg.conf so it matches.

Still having problems? Buy a new video card!

If you want to post your special way of how you got it working - please do. Mine just works all the time so I don't have such problems.


Does this include support for some privately-owned platforms? Yes, Sabayon Linux supports DVDs, MP3, WMA, AAC, DivX. Moreover, it supports a lot of open platforms, such as Ogg Vorbis, Matroska, Ogg Theora, FLAC, and coder-decoder Xvid.


Please Visit our Gaming Shed


Q: Is AIGLX available?

A: If your graphics card is capable, then this should work out-of-the-box. If you are having trouble, start with the Gentoo Wiki article http://en.gentoo-wiki.com/wiki/AIGLX/Troubleshooting.

Q: In HOWTO: Get Ati or Nvidia Video Cards working in Sabayon it states that ATI GPUs can use AIGLX with the closed-source driver FGLRX. Is it feasible? Previously this worked only with XGL and open source DRI (direct giving infrastructure) Radeon driver.

A: AIGLX is supported by both the open-source Radeon driver and the closed-source FGLRX driver. N.B. Not all ATI cards are supported by the closed-source FGLRX driver and must use the Radeon driver. To find out if the closed-source driver supports your ATI card, see the release notes for the relevant version of the FGLRX driver (a.k.a. AMD Catalyst driver for Linux).