Table of Contents
Download and Install GNOME SlackBuild
About the GNOME SlackBuild Binary Distribution
This is our binary GNOME distribution for Slackware and
Slackware64 Linux. It encompasses all needed packages for a fully
configurable, customisable and usable GNOME desktop environment for
Slackware. If you haven't yet, you should read
about the GSB project before installing GSB.
Please consider donating funds to help support the GSB project.
The most current available version of the GSB binary distribution is 3.2
Note: GNOME SlackBuild 3.2 is designed and built for Slackware or Slackware64 13.37 only! It likely will not work on earlier releases of Slackware, and certainly was not built for them.
Important: For users upgrading from a previous GNOME SlackBuild installation, please make sure you're upgrading all the required packages. See Required Package Upgrades for more information.
Before plunging in, please consult the documentation, particularly our Replaced Packages List. You may also want to review the README.TXT. If you are upgrading from a previous version of GSB, read our UPGRADE.TXT.
Quick and Easy Install
The quickest and easiest way to install the GSB binary distribution, is via our net-installer. This method of installation will install everything you need to run a full GNOME desktop environment, as well as GNOME applications. It will also automatically upgrade the various necessary packages, as well as install any dependencies for you.
Login to a terminal as root (in run-level 3, preferred), and run the following command:
Slackware 13.37 for x86
lynx --source http://gnomeslackbuild.org/net-install | bash
Slackware64 13.37 for x86_64
lynx --source http://gnomeslackbuild.org/net-install/64 | bash
For more install options, see the README.
Manual Slapt-get Installation
The package management tool used by GNOME SlackBuild is slapt-get. Slapt-get tries to emulate Debian's apt-get as closely as possible. It uses native Slackware tools, like installpkg, upgradepkg and removepkg, and supports multiple package sources. It is also capable of caching packages, resuming downloads, checking MD5s, searching packages, and resolving dependencies and conflicts. It is the preferred tool when installing GNOME SlackBuild. If you would like more information on slapt-get please see see Slapt-get's home page. GSlapt is also available, and is a GTK version of slapt-get, which integrates well into the GSB GNOME Desktop, and is the default package management application.
Download slapt-get for Slackware 13.37 from: <http://mirrors.gnomeslackbuild.org/gsb/gsb-3.2_slackware-13.37/gsb/ad/>.
Download slapt-get for Slackware64 13.37 from: <http://mirrors.gnomeslackbuild.org/gsb/gsb64-3.2_slackware64-13.37/gsb64/ad/>.
After downloading the slapt-get binary package, you can install it with:
$ installpkg slapt-get-[version].txz
Configuring the slapt-get Package Manager
Once slapt-get is installed, you will need to modify the
/etc/slapt-get/slapt-getrc file to point to local
mirrors of both a Slackware 13.37 mirror as well as a
GNOME SlackBuild mirror. You can find a local Slackware mirror
from the slackware.com mirror list at http://www.slackware.com/getslack/.
A full list of available GNOME SlackBuild Mirrors is given in our
list of mirrors.
The slapt-getrc file consists currently of the following keys:
SOURCE WORKINGDIR EXCLUDE.
SOURCE must be a path to a valid http or ftp Slackware release
directory, or other package source such as linuxpackages.net, or
GNOME SlackBuild. All that is required is the PACKAGES.TXT and
CHECKSUMS.md5. Multiple sources can be defined. Below is a short
slapt-getrcfile. Please note: This is only an example. Make sure to change your SOURCE to point to local mirrors.
WORKINGDIR=/var/slapt-get EXCLUDE=^kernel-.*,^alsa-.*,^glibc.*,.*-[0-9]+dl$,^devs$,^udev$,aaa_elflibs SOURCE=ftp://ftp.slackware.com/pub/slackware/slackware-13.37/:OFFICIAL SOURCE=http://mirrors.gnomeslackbuild.org/gsb/gsb-3.2_slackware-13.37
PACKAGE PRIORITY: Update your /etc/slapt-get/slapt-getrc file to point to Slackware 13.37 and GNOME SlackBuild repositories. Make sure to add the :OFFICIAL tag to the end of your SOURCE= which points to the Slackware repository, and the tag :CUSTOM to the SOURCE= line which points to your GNOMESlackBuild repository. Without the :CUSTOM tag, the official Slackware packages will outweigh GSB packages, and not all required packages will be upgraded.
- EXCLUDE is a comma separated list of packages you want excluded from updating. This can be the package name, or a extended POSIX regex. For example, to exclude Dropline GNOME, use .*-[0-9]dl$. But this is just an example. :^)
- Please make sure that if you are running a x86_64 system, that you do not have x86_64 specified in the EXCLUDE section, or no packages will be found when trying to install via the slapt-get application.
GNOME SlackBuild Mirror List
You best option is to use <http://mirrors.gnomeslackbuild.org/gsb> as your mirror. It is a "smart" mirror redirector, and only uses mirrors which are up-to-date and complete.
The following is a list of available optional mirrors from which to download GNOME SlackBuild. This list is an exact replica of the MIRROR.TXT found in release directory.
GNOME SlackBuild Worldwide Mirror Sites ----------------------------------------- GNOME SlackBuild is distributed on a number of servers across the Internet. Using a nearby server will probably speed up your download, and also reduce the load on our main servers. When you are configuring your slapt-get, please make sure to pick the mirror nearest you. We are happy to call OSUOSL a GSB sponsor, and that they graciously mirror the GSB software repository. This is the same organization & mirror that is the official Slackware mirror :-) The OSUOSL mirror is our official US mirror. OSUOSL sponsors and hosts a wide variety of excellent Open Source projects and initiatives, including, GNOME and Slackware. Show them how much you appreciate what they give to the community by providing a donation at http://osuosl.org/donate. If you know of any mirrors that are missing from this list, please email firstname.lastname@example.org or email@example.com. == GNOME SlackBuild == # United States http://ftp.osuosl.org/pub/gsb/gsb-3.0_slackware-current/ ftp://ftp.osuosl.org/pub/gsb/gsb-3.0_slackware-current/ http://get.gnomeslackbuild.org/gsb/gsb-3.0_slackware-current/ # United Kingdom http://www.slackware.org.uk/gsb/gsb-3.0_slackware-current/ ftp://ftp.slackware.org.uk/gsb/gsb-3.0_slackware-current/ # Russia http://slackware.rol.ru/gsb/gsb/gsb-3.0_slackware-current/ # Poland ftp://ftp.slackware.pl/pub/gnomeslackbuild/gsb/gsb-3.0_slackware-current/ # Germany http://ftp5.gwdg.de/pub/linux/slackware/gsb/gsb-3.0_slackware-current/ ftp://ftp5.gwdg.de/pub/linux/slackware/gsb/gsb-3.0_slackware-current/ http://mirror.informatik.uni-mannheim.de/pub/linux/distributions/slackware-unsupported/gsb/gsb-3.0_slackware-current/ ftp://mirror.informatik.uni-mannheim.de/pub/linux/distributions/slackware-unsupported/gsb/gsb-3.0_slackware-current/ # Belgium http://mirrors.dotsrc.org/gsb/gsb-3.0_slackware-current/ ftp://mirrors.dotsrc.org/gsb/gsb-3.0_slackware-current/ # Switzerland http://mirror.switch.ch/ftp/mirror/gsb/gsb-3.0_slackware-current/ ftp://mirror.switch.ch/ftp/mirror/gsb/gsb-3.0_slackware-current/ # Indonesia http://ftp.paudni.kemdiknas.go.id/gsb/gsb-3.0_slackware-current/ ftp://ftp.paudni.kemdiknas.go.id/gsb/gsb-3.0_slackware-current/ # South Africa ftp://ftp.is.co.za/mirrors/ftp.slackware.com/pub/gsb/gsb-3.0_slackware-current/ # Portugal http://darkstart.ist.pt/slackware/addon/gsb/gsb-3.0_slackware-current/ # Brazil ftp://ftp.slackware-brasil.com.br/gsb/gsb-3.0_slackware-current/ == GNOME SlackBuild64 == # United States http://ftp.osuosl.org/pub/gsb/gsb64-3.0_slackware64-current/ ftp://ftp.osuosl.org/pub/gsb/gsb64-3.0_slackware64-current/ http://get.gnomeslackbuild.org/gsb/gsb64-3.0_slackware64-current/ # United Kingdom http://www.slackware.org.uk/gsb/gsb64-3.0_slackware64-current/ ftp://ftp.slackware.org.uk/gsb/gsb64-3.0_slackware64-current/ # Russia http://slackware.rol.ru/gsb/gsb/gsb64-3.0_slackware64-current/ # Poland ftp://ftp.slackware.pl/pub/gnomeslackbuild/gsb/gsb64-3.0_slackware64-current/ # Germany http://ftp5.gwdg.de/pub/linux/slackware/gsb/gsb64-3.0_slackware64-current/ ftp://ftp5.gwdg.de/pub/linux/slackware/gsb/gsb64-3.0_slackware64-current/ http://mirror.informatik.uni-mannheim.de/pub/linux/distributions/slackware-unsupported/gsb/gsb64-3.0_slackware64-current/ ftp://mirror.informatik.uni-mannheim.de/pub/linux/distributions/slackware-unsupported/gsb/gsb64-3.0_slackware64-current/ # Belgium http://mirrors.dotsrc.org/gsb/gsb64-3.0_slackware64-current/ ftp://mirrors.dotsrc.org/gsb/gsb64-3.0_slackware64-current/ # Switzerland http://mirror.switch.ch/ftp/mirror/gsb/gsb64-3.0_slackware64-current/ ftp://mirror.switch.ch/ftp/mirror/gsb/gsb64-3.0_slackware64-current/ # Indonesia http://ftp.paudni.kemdiknas.go.id/gsb/gsb64-3.0_slackware64-current/ ftp://ftp.paudni.kemdiknas.go.id/gsb/gsb64-3.0_slackware64-current/ # South Africa ftp://ftp.is.co.za/mirrors/ftp.slackware.com/pub/gsb/gsb64-3.0_slackware64-current/ # Portugal http://darkstart.ist.pt/slackware/addon/gsb/gsb64-3.0_slackware64-current/ # Brazil ftp://ftp.slackware-brasil.com.br/gsb/gsb64-3.0_slackware64-current/ Last Updated: Sat Apr 30 15:14:49 GMT 2011
After installing and customizing the
slapt-getrc configuration file, you need to run:
$ slapt-get --update $ slapt-get --add-keys
This will download the package data available from all the package sources you specified
slapt-getrc file and all gpg keys.
After the package data has been updated, the first step to installing GNOME SlackBuild is to upgrade the required packages. If you do not replace the required packages, GNOME SlackBuild will not run properly.
NOTE ON REQUIREMENTS: You must first upgrade and replace all packages marked as required in the Replaced Packages List. If you fail to do so, your installation may not work. Run the following command before attempting to install GNOME SlackBuild:
$ slapt-get --install glib2 gtk+2
However, while GNOME SlackBuild is designed to replace as few Slackware packages as possible, it is not possible to free ourselves wholly from replacing some packages. There are three packages that are optional and replace official Slackware packages, but their replacement are only necessary for added functionality, or for certain GNOME applications. Their replacement is recommended, but not required if you do not plan to use certain applications, or are dead set against replacing any Slackware provided packages.
$ slapt-get --remove-obsolete --upgrade
For a full list of available options, please consult the slapt-get manual.
Downloading and Installing a Basic Desktop
After replacing the required packages, you are now
ready to install GNOME SlackBuild. GNOME SlackBuild provides
a number of metapackages in order to ease the installation of
huge package lists via slapt-get. The recommended
installation method is to first install the basic GSB GNOME Desktop
gsb-desktop metapackage. It contains all the
packages required for a working and useable GNOME Desktop, including Epiphany,
Evolution, the GNOME Display Manager (GDM), and Gslapt
for package management as well as some basic themes and desktop utilities.
From here, additional packages can be added to suit the users needs.
To install your basic GNOME SlackBuild GNOME Desktop, run:
$ slapt-get --install gsb-desktop
This process may take a long time, depending on the speed of your connection. It will first download all the required packages and install them. After installation, it is also strongly recommended that you reboot your system. After, you can use gslapt (from your GNOME desktop) or slapt-get from the command line to install additional packages you may want.
IMPORTANT! Fix your config files. Some of the config files in /etc are going to need your attention. You'll find the new incoming config files on your system with the ".new" extension. You may need to fill these in with information from your old config files and then move them over.
Uninstalling GNOME SlackBuild
In order to uninstall GNOME SlackBuild, you'll first need to remove all GNOME SlackBuild packages, and then re-install any Slackware provided packages that may have been replaced by GSB ones. It is recommended that you drop to runlevel 1 (Single-user mode) while you uninstall. You will need your original Slackware CD in order to re-install some standard Slackware packages, or else a working internet connection if you want to use slapt-get to reinstall these packages. You can remove all GNOME SlackBuild packages by running:
$ removepkg /var/log/packages/*gsb
This will remove all packages that are provided by GNOME SlackBuild. You'll need to
comment out the SOURCE for GNOME SlackBuild in your
Then make sure to rerun
slapt-get --update. After you have uninstalled GNOME SlackBuild, you'll need to reinstall
a few standard Slackware packages by running:
$ slapt-get --reinstall --install glib2 gtk+2
You may also need to reinstall other packages that may have been replaced, such as libgsf, gst-plugins-good or compiz. Remember to refer to the Replaced Packages List for any packages you may need/want to re-install.
GNOME SlackBuild v3.2 is considered stable, but with only a few volunteers to help build and test it, we cannot guarantee that it is free from errors. :) If you find any bugs in GNOME SlackBuild, please help us and the GNOME SlackBuild project out by reporting them. The preferred and best way is by sumitting a bug report in our bug reporting tool.