Home Forums Wiki Doc Install Extras Screenshots Source Code Projects Blog Users Groups Register
Glx-Dock / Cairo-Dock Wiki First Steps
The latest stable release is the *3.4.0* : How to install it here.
Note: We just switched from BZR to Git on Github! (only to host the code and your future pull requests)
Information : The version displayed on this page is not the latest available.
History View code

Glx-Dock / Cairo-Dock



Support Us

Flattr this


First Steps

This page is under construction.
If you would like to participate in its redaction or simply give your opinion then please visit the forum here

For that first Launch

To launch Cairo-Dock:
  • Go to Applications / Systems / Cairo-Dock or GlxDock (Cairo-Dock with OpenGL)
  • Press Alt + F2 and type cairo-dock in the box that opened then validate.
  • You can also do it from a terminal:
For ATI cards owners you have to force Cairo-Dock to don't use OpenGL :
cairo-dock -c

Launch Cairo-Dock at Startup

With the 2.0 release, you can choose between using Cairo-Dock with or without OpenGL. With OpenGL, the use of your video card is maximized and the dock with many effects and plug-ins is fluid all the time even with a CPU under heavy load! Unfortunately all ATI and many Intel cards don't support the OpenGL v2 as well as Nvidia cards. For the owner of ATI or Intel video card, for which DRI2 support is under development, as well as for the legacy video card which do no support OpenGL v2, the cairo back-end is still available. This allow everybody to be able to enjoy most of the dock's improvements and the new applets. But, this drivers are improving every day and we hope that you can use Cairo-Dock with OpenGL with every graphics cards!
Note that with the "same" config of AWN and Cairo-Dock without OpenGL, Cairo-Dock use less CPU than AWN.

To don't have a message at startup to choose which mode you will use, launch Cairo-Dock with one of these two commands :

Cairo-Dock with OpenGL

Cairo-Dock with Cairo back-end

For Gnome
Menu : System> Preferences> Sessions> Select the tab "Startup Programs> Add
Enter the commands for the program: cairo-dock -o (with OpenGL) or cairo-dock -c (without OpenGL)

KDE Configuration Center> KDE Components> Add
Enter the commands for the program: cairo-dock -o (with OpenGL) or cairo-dock -c (without OpenGL)

Menu :
Parameters> Applications started Automatically> Add
Enter the commands for the program: cairo-dock -o (with OpenGL) or cairo-dock -c (without OpenGL)

Recurrent problems
A black background? Problem with (S)Mplayer or VirtualBox?
See that : Recurrent problems

For Beryl User
you only see the dock on one of the face of the cube! (no problem with Compiz-fusion now )
In case you launch Cairo-Dock at startup and you are using Beryl, you will have to use a little script to delay the startup of the dock.

Create a file called launch-cairo-dock-after-beryl.sh, and copy/paste the following code in it:

#we wait 12 seconds so that Beryl gets ready (you may need more or less)
sleep 12
# the path of cairo-dock (may be different for you)
cairo-dock &

Make it executable
sudo chmod +x launch-cairo-dock-after-beryl.sh

And use that script to launch the dock at startup


Click here for more
To configure them right click on them >>
Configure this module

For the applets that are inactive: right click and choose
Cairo-Dock >> Configure >> System or Applets (if you are in Advanced mode)


Click here for more
To create a launcher you can either drag'n drop directly from the
Application Menu onto the dock or do it all manually: right click >>add a Launcher

To remove one: right click and select
Remove this launcher


Sub dock are icons that contains launchers see them as
menu>sub menu: Right click and selectAdd a sub-dock

Applicable for Applications/Launchers and sub-docks/applets

By Drag and Drop or right click >>
Move this icons and for the launcher also from right click >>Modify this launcher >> Extra parameters++ and select a numerical order value :
=>1 for first position, 1.7, 2, 3, 4, 4.5, 4.550 etc...

Cairo-Dock needs you
Several research on the web shows that some people have been able to use the dock on a few Linux distributions:
  • Ubuntu (Cairo-Dock is developed on that distribution)
  • Fedora
  • ArchLinux
  • Mandriva
  • Gentoo

As well as a few windows manager:
  • Gnome (of course)
  • KDE
  • Xfce

No definitive tutorial though just a few links. If you have some linsk to tutorial (wiki, website, blog,etc...) or some RPMs, basically anything that would help others to install the dock on their system.
Just make sure that the information is up to date.

Glx-Dock / Cairo-Dock Wiki First Steps Top

Online users :

Powered by ElementSpeak © 2007 Adrien Pilleboue, 2009-2013 Matthieu Baerts.
Dock based on CSS Dock Menu (Ndesign) with jQuery. Icons by zgegball
Cairo-Dock is a free software under GNU-GPL3 licence. First stable version created by Fabounet.
Many thanks to TuxFamily for the web Hosting and Mav for the domain name.