(→Mac OS X: Added alternative install method using Nix.)
Latest revision as of 23:31, 28 December 2011
 1 Read me first
After installing, you'll have an
xmonad binary on your system. From there, you'll need to wire xmonad up to your login manager.
 2 Linux
 2.1 Arch
$ pacman -S xmonad-contrib # for the xmonad core and contrib packages
$ pacman -S xmonad # for just the xmonad core package
See xmonad on ArchWiki for more info.
 2.2 Debian
$ apt-get install xmonad # for just the xmonad binary, without the ability to configure
In addition to that, if you want to write a configuration file, you should get one of these:
$ apt-get install libghc6-xmonad-contrib-dev # for all of xmonad core and xmonad-contrib (depends on the following pkg) $ apt-get install libghc6-xmonad-dev # for just xmonad core
There are also -doc and -prof suffixes for various packages. I'm not sure what they contain.
Note: The are backports available for debian etch at http://newpeople.debian.org/~jps/etch/.
 2.3 Fedora
$ yum install xmonad
Additionally install ghc-xmonad-devel and ghc-xmonad-contrib-devel
$ yum install ghc-xmonad-contrib-devel
xmonad is also available in EPEL for rhel6.
 2.4 Gentoo
$ emerge xmonad-contrib # the contrib package depends on xmonad so it gets also installed
if you only want to install xmonad without contrib you could use: $ emerge xmonad
An actively maintained haskell overlay contains many newer or more obscure versions of projects, including ebuilds for darcs xmonad/contrib, cabal-install, haskellmode for vim, and many other goodies.
 2.5 Gobo
 2.6 NixOS
#nix-env --install xmonad
the correct version for your arch should be then installed and you will have to take the configuration from there, currently (2011-08-18) this does not result in a working xmonad.
 2.7 Slackware
 2.8 Source Mage
 2.9 Ubuntu
Note: On Hardy Heron and earlier, the libghc6-x11-dev package was compiled without Xinerama support. This means that if you want multi-monitor support, you have three options:
- upgrade to >= Intrepid Ibex
- install xmonad (and the Haskell X11 library on which it depends) through one of the #Generic options
- follow the instructions in this blog post to recompile the libghc6-x11-dev yourself (unverified)
 3 BSD
 3.1 FreeBSD
For only the window manager:
# cd /usr/ports/x11-wm/hs-xmonad # sudo make install distclean
And the contrib package:
# cd /usr/ports/x11-wm/hs-xmonad-contrib # sudo make install distclean
 3.2 NetBSD
 3.3 OpenBSD
xmonad is in the ports tree. To install it,
sudo pkg_add xmonad
 4 Mac OS X
Install ghc using MacPorts:
$ port install ghc
And then follow one of the #Generic instructions.
Alternatively install a ghc wrapper and xmonad with Nix.
$ nix-env -i <package>
See more at Xmonad/Using xmonad on Apple OSX.
 5 Generic
 5.1 From tarball
 5.2 From Hackage
xmonad can be installed from source on any system with an up-to-date Haskell toolchain:
$ cabal install xmonad