Home Forums Wiki Doc Install Extras Screenshots Source Code Projects Blog Users Groups Register
Glx-Dock / Cairo-Dock Wiki From the repository
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)
History View code

Glx-Dock / Cairo-Dock

Home

History

Support Us

Flattr this

Cairo-Dockon

From the repository

Ubuntu
(For Debian and other forks, etc.: have a look at the bottom. For Linux Mint users, please use our PPA (have a look to the next text box) instead of our repository)

http://download.tuxfamily.org/glxdock/images/scbutton-free-200px.png


Installation with one copy-paste
PPA
Only FOR UBUNTU and forks (Linux Mint), NOT for Debian and other forks (Linux Mint Debian Edition, etc.).

Simply copy-paste all this box in a terminal :
sudo -v

sudo add-apt-repository ppa:cairo-dock-team/ppa
sudo apt-get update
sudo apt-get install cairo-dock cairo-dock-plug-ins # or if the dock is already installed => # sudo apt-get dist-upgrade


Repository
Note that a mirror is also available on Tuxfamily servers (for Ubuntu only!):
sudo -v
Please write your password (it's invisible )
echo "deb http://download.tuxfamily.org/glxdock/repository/ubuntu $(lsb_release -sc) cairo-dock" | sudo tee -a /etc/apt/sources.list
wget -q http://download.tuxfamily.org/glxdock/repository/cairo-dock.gpg -O- | sudo apt-key add -
sudo apt-get update
sudo apt-get install cairo-dock cairo-dock-plug-ins # or if the dock is already installed => # sudo apt-get dist-upgrade
(For Debian, and other forks, etc.: have a look at the bottom)
(Note: The 2nd line is long and is maybe displayed as 2 lines on the page, but it's a single line.)

Installation with details


It is highly recommended to download a signed key for authentication. It will also remove the error message to inform you about security issue. To download and install the key just run the following command in a terminal:

wget -q http://download.tuxfamily.org/glxdock/repository/cairo-dock.gpg -O- | sudo apt-key add -


Edit your sources.list
sudo gedit /etc/apt/sources.list
and add the following line corresponding to your release:

For Lucid Lynx 10.04 LTS:
deb http://download.tuxfamily.org/glxdock/repository/ubuntu lucid cairo-dock


For Maverick Meerkat 10.10:
deb http://download.tuxfamily.org/glxdock/repository/ubuntu maverick cairo-dock


For Natty Narwhal 11.04:
deb http://download.tuxfamily.org/glxdock/repository/ubuntu natty cairo-dock


For Oneiric Ocelot 11.10:
deb http://download.tuxfamily.org/glxdock/repository/ubuntu oneiric cairo-dock


For Precise Pangolin 12.04:
deb http://download.tuxfamily.org/glxdock/repository/ubuntu precise cairo-dock


Then update your repository list and install cairo-dock and cairo-dock-plug-ins (it may install dependencies) :

sudo apt-get update
sudo apt-get install cairo-dock


Problems during install or update on Ubuntu Intrepid 8.10 or newer

If you got the following message during fresh install or update:
trying to overwrite `/usr/share/cairo-dock/default-indicator.png', which is also in package cairo-dock-data
dpkg-deb: subprocess paste killed by signal (Broken pipe)


It's caused by packages included on Ubuntu repositories... Here is the workaround :
sudo apt-get remove cairo-dock* --purge
sudo apt-get install cairo-dock cairo-dock-plug-ins


For any problems with the repository please report on the forum of Cairo-Dock if your bug isn't mentioned on this section: Recurring Problems.




Debian

Installation with one copy-paste
Simply add this line on your /etc/apt/sources.list (don't forget to replace #CODENAME# by stable/testing/unstable)
deb http://download.tuxfamily.org/glxdock/repository/debian #CODENAME# cairo-dock ## Cairo-Dock Stable
Then, copy-paste all this box in a terminal of your Debian stable/testing/unstable
su
wget -q http://download.tuxfamily.org/glxdock/repository/cairo-dock.gpg -O- | apt-key add -
apt-get update
apt-get install cairo-dock cairo-dock-plug-ins




Force APT to use packages from our repository
It's recommended to force APT to use Cairo-Dock's packages from our repository instead of Cairo-Dock's packages from official Debian repositories (because the latter are poorly made with a lot of unnecessary dependencies). For that, simply create this file: /etc/apt/preferences.d/cairo-dock
With this content:
Package: cairo-dock* libgldi*
Pin: origin download.tuxfamily.org
Pin-Priority: 990




Linux Mint Debian Edition (LMDE)

LMDE's repos are not always sync with Debian Testing repo!
If yes, simply launch this command to add our repo:
echo "deb http://download.tuxfamily.org/glxdock/repository/debian testing cairo-dock ## Cairo-Dock Stable" | sudo tee -a /etc/apt/sources.list
And then:
wget -q http://download.tuxfamily.org/glxdock/repository/cairo-dock.gpg -O- | apt-key add -
apt-get update
apt-get install cairo-dock cairo-dock-plug-ins




If you're not able to install Cairo-Dock from our repo, it means that Linux Mint Debian Edition repositories are no longer sync with Debian testing repositories. This is why it's no longer possible to use our Debian repos.
If you want to install the latest stable version (we recommend it ), you'll have to compile the sources (because there is no special repos here for LMDE but feel free to ask again on our forum ). It's not complicated, there are 3 possibilities:
  • Rebuild the deb packages (have a look bellow)
  • By compiling the sources
  • By using a script to compile the development version (it's quite stable because we use it everyday ) and don't forget to report any bugs of this version

For more information about this problem, please have a look to this topic: http://www.glx-dock.org/bg_topic.php?t=5815

Rebuild deb packages
It's maybe the cleanest way but it's possible that the build fail if there are too much differences between LMDE and Debian Testing. If there are problems, please report these bugs on our forum.
  • Add our Debian repo with the sources by adding this line in this file /etc/apt/sources.list
    deb-src http://download.tuxfamily.org/glxdock/repository/debian testing cairo-dock
    (if you've modified the priorities, don't forget to add an exception for this repo)
  • Install all dependences:
    sudo apt-get update
    sudo apt-get install build-essential devscripts
    sudo apt-get build-dep cairo-dock
  • Download the sources into a new directory:
    apt-get source cairo-dock cairo-dock-plug-ins
    If it doesn't download our packages (from download.tuxfamily.org/glxdock), it's maybe easier to download them with dget tool by using .dsc files of the latest stable version for Debian Testing (for cairo-dock and cairo-dock-plug-ins) available there: cairo-dock & cairo-dock-plug-ins. For example:
    dget -u http://download.tuxfamily.org/glxdock/repository/debian/pool/cairo-dock/c/cairo-dock/cairo-dock_3.0.2-0%7etesting.dsc
    dget -u http://download.tuxfamily.org/glxdock/repository/debian/pool/cairo-dock/c/cairo-dock-plug-ins/cairo-dock-plug-ins_3.0.2-0%7etesting.dsc
  • Re-build our packages:
    • Core:
      cd cairo-dock ## the directory may contain a version number
      dch -i "Rebuild for Debian"
      dpkg-buildpackage
      cd ..
      sudo dpkg -i libgldi*.deb
      sudo apt-get install -f ## to install new dependences
    • Plugins:
      cd cairo-dock-plug-ins ## the directory may contain a version number
      sudo apt-get build-dep cairo-dock-plug-ins
      dch -i "Rebuild for Debian"
      dpkg-buildpackage
      cd ..
      sudo dpkg -i *.deb ## installation of the new packages (but ++*-dbg.deb++ packages are only useful to debug crash)
      sudo apt-get install -f ## to install new dependences
  • Et voilà, it's done! Note that you can also uninstall *-dbg.deb packages and also other dependences downloaded to build these packages. Don't forget that you'll have to do that for each new version of the dock




Quick-start guide
For stable release:
deb http://download.tuxfamily.org/glxdock/repository/debian stable cairo-dock


For testing release:
deb http://download.tuxfamily.org/glxdock/repository/debian testing cairo-dock


For unstable release:
deb http://download.tuxfamily.org/glxdock/repository/debian unstable cairo-dock


The PGP Key:
wget -q http://download.tuxfamily.org/glxdock/repository/cairo-dock.gpg -O- | sudo apt-key add -




Installation with details

It is highly recommended to download a signed key for authentication. It will also remove the error message to inform you about security issue. To download and install the key just run the following command in a terminal:

wget -q http://download.tuxfamily.org/glxdock/repository/cairo-dock.gpg -O- | sudo apt-key add -


Edit your sources.list (sudo gedit /etc/apt/sources.list) and add the following line:

For stable release (squeeze) :
deb http://download.tuxfamily.org/glxdock/repository/debian stable cairo-dock


For testing release (squeeze) :
deb http://download.tuxfamily.org/glxdock/repository/debian testing cairo-dock


For unstable release (testing/unstable) :
deb http://download.tuxfamily.org/glxdock/repository/debian unstable cairo-dock


Then update your repository list and install cairo-dock and cairo-dock-plug-ins (it may install dependencies) :

sudo apt-get update
sudo apt-get install cairo-dock cairo-dock-plug-ins


For any problems with the repository please report on the forum of Cairo-Dock if your bug isn't mentioned on this section : Recurrent Problems.




Linux Mint and other Debian-forked
For Linux Mint you can use the same repository as Ubuntu corresponding to your version :
Ubuntu . >> . Linux Mint
Hardy (8.04) . >> . Elyssa (5)
Jaunty (9.04) . >> . Gloria (7)
Karmic (9.10) . >> . Helena (8)
Lucid (10.04) . >> . Isadora (9)
Maverick (10.10) . >> . Julia (10)
Natty (11.04) . >> . Katya (11)
Onerik (11.10) . >> . Lisa (12)
Precise (12.04) . >> . Maya (13)
Quantal (12.10) . >> . Nadia (14)
Raring (13.04) . >> . Olivia (15)
Saucy (13.10) . >> . Petra (16)
Simply have a look to this method here and replace the Ubuntu version by the corresponding given here. But simply use our ppa (see the first box at the beginning of this wiki page)
For other you can use the stable or unstable debian repository



About these repositories

All Official Repositories are signed with that Key:

Name Cairo-Dock Team

E-Mail repository@glx-dock.org

Key-ID 0x41317877

Key Fingerprint 7F519117BF5E1805D98075E21392A97E41317877


Glx-Dock / Cairo-Dock Wiki From the repository 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.