updated note about ubuntu versions
[monkeysphere.git] / website / download.mdwn
index 019fbcf48b4ea8ab3b7ea43c23f8c1d898715ae5..d2352944da507a33d44889774df3d21198d7b673 100644 (file)
 [[meta title="Download"]]
 
-## Downloading and Installing ##
+# Downloading and Installing #
 
-If you are running a Debian system, you can install Monkeysphere
-by following these directions:
+Once you've installed the packages, please see the [documentation
+page](/doc) to read up on how to get started [as a regular
+user](/getting-started-user) or [as a systems
+administrator](/getting-started-admin).
 
-You can add this repo to your system by putting the following lines in
-`/etc/apt/sources.list.d/monkeysphere.list`:
+## Dependencies ##
 
-       deb http://archive.monkeysphere.info/debian experimental monkeysphere
-       deb-src http://archive.monkeysphere.info/debian experimental monkeysphere
+Monkeysphere relies on:
+
+ * [OpenSSH](http://openssh.com/)
+ * [GnuPG](http://gnupg.org/)
+ * [Perl](http://www.perl.org/) (including the [Crypt::OpenSSL::RSA](http://search.cpan.org/dist/Crypt-OpenSSL-RSA/) and [Digest::SHA](http://search.cpan.org/dist/Digest-SHA/) modules and their dependencies)
+
+## Debian ##
+
+If you are running a [Debian](http://www.debian.org/) system, the
+[monkeysphere is available in the Debian archive](http://packages.debian.org/search?keywords=monkeysphere&searchon=names&section=all&suite=all)
+
+If you are running Debian unstable or testing install the latest monkeysphere
+version as follows:
+
+    aptitude install monkeysphere
+
+If you are running Debian stable, you can get the monkeysphere package
+from [backports.org](http://backports.org/dokuwiki/doku.php?id=instructions)
+
+## Debian derivatives (including Ubuntu) ##
+
+You can also install the Monkeysphere directly from the Monkeysphere
+APT repository.  You can add this archive to your system by putting
+the following lines in `/etc/apt/sources.list.d/monkeysphere.list`:
+
+    deb http://archive.monkeysphere.info/debian experimental monkeysphere
+    deb-src http://archive.monkeysphere.info/debian experimental monkeysphere
 
 The repository is currently signed by [The Monkeysphere archive
-signing key](/archive-key), key id EB8AF314 (fingerprint: `2E8D
-D26C 53F1 197D DF40 3E61 18E6 67F1 EB8A F314`).  To cryptographically
+signing key](/archive-key), key id EB8AF314 (fingerprint: `2E8D D26C
+53F1 197D DF40 3E61 18E6 67F1 EB8A F314`).  To cryptographically
 verify the packages, you'll want to [add this key to your apt
-configuration after verifying its
-integrity](http://wiki.debian.org/SecureApt).
+configuration after verifying its integrity](/archive-key).
 
-Once you've installed the packages, you might want to read up on how
-to get started [as a regular user](/getting-started-user) or [as a
-systems administrator](/getting-started-admin).
+Note: Ubuntu shipped Monkeysphere 0.22 in their "Jaunty Jackalope"
+release (9.04).  The Monkeysphere developers think that [Ubuntu
+shipping Monkeysphere 0.22-1 is a bad
+idea](https://bugs.launchpad.net/ubuntu/+source/monkeysphere/+bug/345054).
+If you are an Ubuntu user, we would prefer that you install from the
+APT archive above rather than run 0.22, which we no longer consider
+supported.
 
-## Enhancements ##
+Ubuntu users running "Karmic Koala" (9.10) or later should see version
+0.26-1 or later in the standard Ubuntu universe repository, so please
+use the regular Ubuntu repositories if you're running Karmic or later.
 
-As of 2008-08-22, If you run debian lenny you're very close to being
-able to run a fully monkeysphere-enabled system.  One gap in the
-system is that lenny's GnuTLS can't support the `monkeysphere
-subkey-to-ssh-agent` subcommand.
+## FreeBSD ##
 
-You can install a patched version of GnuTLS to enable this feature of
-the MonkeySphere by adjusting the monkeysphere `sources.list` lines to
-include the `gnutls` component.  So they'd look like this instead:
+There is [a FreeBSD port
+available](http://www.freebsd.org/cgi/ports.cgi?query=monkeysphere)
+for the Monkeysphere, built and tested against FreeBSD 7.1.
 
-       deb http://archive.monkeysphere.info/debian experimental monkeysphere gnutls
-       deb-src http://archive.monkeysphere.info/debian experimental monkeysphere gnutls
+You should be able to build and install the latest port with:
 
-You can [read more about this offering](/news/modified-gnutls-2.4.x-available).
+    cd /usr/ports/security/monkeysphere
+    make package
+
+Enjoy!
+
+## Slackware ##
+
+Silvio Rhatto has made [a SlackBuild
+script](http://slack.sarava.org/slackbuilds/net/misc/monkeysphere/)
+for the Monkeysphere, tested against Slackware 12.2.
+
+This is generated by [the mkbuild system](http://simplepkg.sarava.org)
+from [its .mkbuild
+source](http://slack.sarava.org/mkbuilds/net/misc/monkeysphere/).
+
+Thanks, rhatto!
 
 ## Source ##
 
-For people who can't use the debian package, or folks who just want to
-look at the source, we recommend [using git](/community).
+For those that would like to download the source directly, [the source
+is available](/community) via [git](http://git.or.cz/).
 
-But if you want a tarball of the most recent release, we publish those
-too.  The [latest
-tarball](http://archive.monkeysphere.info/debian/pool/monkeysphere/m/monkeysphere/monkeysphere_0.14.orig.tar.gz)
-has this sha1sum:
+The [latest
+tarball](http://archive.monkeysphere.info/debian/pool/monkeysphere/m/monkeysphere/monkeysphere_0.26.orig.tar.gz)
+is also available, and has these checksums:
 
 <pre>
 -----BEGIN PGP SIGNED MESSAGE-----
-Hash: SHA1
+Hash: SHA512
+
+checksums for the monkeysphere 0.26 release:
 
-sha1sum for the monkeysphere 0.14 release:
+MD5:
+f0e5fe66a9affd951e601ea5d6188972  monkeysphere_0.26.orig.tar.gz
 
-8b05fec041cec7f86ddde92fa72c8aabf8af0b3b  monkeysphere_0.14.orig.tar.gz
+SHA1:
+de0125e43c8c7d7d98f45f9395576ff06e150307  monkeysphere_0.26.orig.tar.gz
+
+SHA256:
+e743a0642f0da5d6ecea6cb3c8ff6c05ac56a094c351a7fdca2a4a707fe05c00  monkeysphere_0.26.orig.tar.gz
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.9 (GNU/Linux)
 
-iQIVAwUBSMAaEhjmZ/HrivMUAQIgIg/+NyMdTzpnxfR+PRaN74uz/vcrDoS3DN+v
-f7h+af1nNfoqJzj7nk+/J8fj3Kukei27Ur/KYiyd0OKoucW80Ajm3A+QCTu/uGLJ
-/uT6L60ERyfBearf4CrIb0IesISZLqzxs1bA0+IswxueYy0GBXcVSuS7v0GIWmHb
-bOJ4yHELYo53Bc/vrtZVW4D4hEiShgesbTFtLYUFTrtALODQqbwEN+shWRo6DzjB
-lttuJV0T6KB5z4tLACbAoTGFQoamfTbJ/1WAxyQg6pIzdRUCnLIwmFjaQ7Xjv6b1
-Td8YR+KhkTjPq/gjQCiEBN9xjozOm0sLUnpTgJNOpRcR+ktQ84eT3mvu3AQnRrVh
-7nX2NSp1RRU5qMWMv3cdTkGWKGi6WfixZarTuMSPwLjDkwAoto7XItV+XDZa4eTc
-7QYwssL+rh5sq61Vq8x0g7Pm7LfA+u2AU79PWYPBc5VsMWyxhmYVsm/JwmLYp/An
-Ak0zWUwd6993/s8qi827/J5b86TXN+OeAONvP5dd+ugiFNDqjfCoiUC6gMCi/V5j
-ptLhnnd2frcNKJLlhYp1dit61IMXuQZkLow6y+2ao/jfXNIPQ/koRJo0bxaFAgBc
-CeivTZkWjINVSN630L8y4uQnx9ag0pybrYTarmICM41QhtVS4M09s6rSPEjY6ppZ
-okLO90tgcpQ=
-=rrij
+iQIVAwUBSnSzIRjmZ/HrivMUAQqQdw//SZ5OrjB+FFe/+sRyRBv3YcjSO7Iif8uo
+ZG8LPbba9v0qUT/pOvMTXij2Wm3dFwgphrNCJgYriHx/0MdvPuHpz+TXRIVFRD7Q
+CNHrG9kuf6BFClqyQwqD1/5FMehu8hEWm0DdyEhB5pUcHzo9ExpjFGGImpI/XvZz
+/HWL7hCoZvJ8iBKyZ0dNSbDZA8WcWkYVKbc42sYYpqHM4kVjfQq37vUDBgq78d4d
+rTDiEF1+4kuwZtKKxJq8woN9+/5atpknFcnICSOobeX1PAOkj96yEAczr39pQNam
+3z2YjdQM0tJsGjguYIiYxwUAs38a/p+rX7+PvS5xY85RCLSsgOplnhSLXluXp5fO
+7Ok2FFmimxYcNfsKFaJQiOa3OaRW6u15+sxb7KNC+raNVwyw8fsaDe7eKGx/xQI5
+fnvjFHJDM3HwzBSRNcBZNacsMAfq0jaN4BAalv9nzpcynsG+vkNI6mus9eopC9/n
+9UwhMRpObndSjNoR/Erbh99jv0mvTeqdG9h9Kjbr38TT5qLWSYRftK7FHglZMmzN
+or3lgUs3bTc6bJlWE9YvGlwEduaaEY0us7fW4nPDQhT+OCHCrjCBk1ppA4SzAnE1
+qTUt5Fa7vjLPaefT58qKRXlglUhsbtVabVoeCFKBFvAebm/XS3kPh2P9Qfk6azQ7
+iJM65kCCil0=
+=tyHC
 -----END PGP SIGNATURE-----
 </pre>
-