Plank:Installing

Contents

Packages

Ubuntu

Plank is not included in the official Ubuntu repositories yet. The Plank Testing PPA contains the in-development version of Plank (there is no stable release yet). That said, the development version works well enough that it shouldn't be a problem for daily use.

The Plank Testing PPA lives at https://launchpad.net/~ricotz/+archive/docky. To install Plank for Ubuntu 12.04 (Precise Pangolin) and later :

  sudo add-apt-repository ppa:ricotz/docky # <- is not a typo
  sudo apt-get update
  sudo apt-get install plank

To update Plank, if you installed Plank as a package from either the official repositories or one of our PPAs, run:

  sudo apt-get update
  sudo apt-get upgrade

Installing From Source

Install Dependencies

To build Plank, you will need to install the following packages:

Ubuntu, Debian, or derived system

Ubuntu, Debian and derived systems are fully supported by Plank.

For Ubuntu 12.04 (Precise Pangolin) and higher:

 sudo add-apt-repository ppa:ricotz/docky
 sudo apt-get update
 sudo apt-get install bzr gnome-common
 sudo apt-get build-dep plank

You may need to build bamf if you choose to not install it from the plank testing ppa:

 sudo apt-get build-dep bamf
 bzr branch lp:bamf
 # switch to the bamf/ source directory you just checked out
 cd bamf/
 ./autogen.sh --prefix=/usr
 make
 sudo make install

To uninstall bamf, switch to the bamf/ source directory:

 cd bamf/
 sudo make uninstall

Other Distributions

TBD (TK TK)

Install From Source

Once all the dependencies are installed, the Plank source can be branched by:

 bzr branch lp:plank

and then built and installed system wide by:

 cd plank/
 ./autogen.sh --prefix=/usr
 make
 sudo make install

Or to install into the home directory of the current user:

 cd plank/
 ./autogen.sh --prefix=$HOME/.local
 make
 make install

The Plank binary will then end up at ~/.local/bin/plank

Updating

If you followed the directions above to install from source, run:

 sudo make uninstall
 bzr pull

in the bamf/ (if you installed from source) and the plank/ source directory. Then to recompile and install the updated version, run:

 sudo make uninstall
 ./autogen.sh --prefix=/usr
 make
 sudo make install

in the bamf/ directory (again, only if you built bamf from source) and then the plank/ source directory.