added releasenote for 0.27
[monkeysphere.git] / website / download.mdwn
index 5551b52985f21ecbfda75417bdc3e310a7513df3..e026e811dbef922153be00656f70b4c0b6498a35 100644 (file)
@@ -2,55 +2,83 @@
 
 # Downloading and Installing #
 
+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).
+
+## Dependencies ##
+
+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 system, you can install Monkeysphere
-by following these directions:
+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)
 
-You can add this repo to your system by putting the following lines in
-`/etc/apt/sources.list.d/monkeysphere.list`:
+## Debian derivatives (including Ubuntu) ##
 
-       deb http://archive.monkeysphere.info/debian experimental monkeysphere
-       deb-src http://archive.monkeysphere.info/debian experimental monkeysphere
+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).
 
-To use the `monkeysphere subkey-to-ssh-agent` subcommand, you will
-also need [version 2.6 of GnuTLS](/news/gnutls-2.6-enables-monkeysphere),
-which is available in Debian experimental.
+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.
 
-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).
+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.
 
 ## FreeBSD ##
 
-There is [now a FreeBSD port available](/news/FreeBSD-port-available/)
-for the Monkeysphere.
+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.
 
-While the monkeysphere is not officially included in the ports tree
-yet, [a problem
-report](http://www.freebsd.org/cgi/query-pr.cgi?pr=ports/128406) has
-been submitted, and the package itself is functional.
+You should be able to build and install the latest port with:
 
-The latest version of the ports directory can be found in [the git
-repository](/community) under
-`packaging/freebsd/security/monkeysphere`.  Please [let us
-know](/community) if you encounter any problems with it on a FreeBSD
-system.
+    cd /usr/ports/security/monkeysphere
+    make package
 
-Until the port is accepted, you should be able to build the latest
-port with:
+Enjoy!
 
-    git clone git://git.monkeysphere.info/monkeysphere
-    cp -a monkeysphere/packaging/freebsd/security/monkeysphere /usr/ports/security
-    cd /usr/ports/security/monkeysphere
-    make && make install
+## 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 ##
 
@@ -58,38 +86,38 @@ For those that would like to download the source directly, [the source
 is available](/community) via [git](http://git.or.cz/).
 
 The [latest
-tarball](http://archive.monkeysphere.info/debian/pool/monkeysphere/m/monkeysphere/monkeysphere_0.19.orig.tar.gz)
+tarball](http://archive.monkeysphere.info/debian/pool/monkeysphere/m/monkeysphere/monkeysphere_0.27.orig.tar.gz)
 is also available, and has these checksums:
 
 <pre>
 -----BEGIN PGP SIGNED MESSAGE-----
-Hash: SHA1
+Hash: SHA512
 
-checksums for the monkeysphere 0.19 release:
+checksums for the monkeysphere 0.27 release:
 
 MD5:
-64c643dd0ab642bbc8814aec1718000e  monkeysphere_0.19.orig.tar.gz
+1b664bb2f699914071eab58da410f568  monkeysphere_0.27.orig.tar.gz
 
 SHA1:
-ea3c263b084d2c0b7922cd96677be192201700e4  monkeysphere_0.19.orig.tar.gz
+7bb926bd58602a4e760e2794cfbda9c54a187e0a  monkeysphere_0.27.orig.tar.gz
 
 SHA256:
-321b77c1e10fe48ffbef8491893f5dd22842c35c11464efa7893150ce756a522  monkeysphere_0.19.orig.tar.gz
+3757554c0e17081b8d30d7550d00a1aca3d886b194f8ba3871f68b457de9d3b9  monkeysphere_0.27.orig.tar.gz
 -----BEGIN PGP SIGNATURE-----
-Version: GnuPG v1.4.9 (GNU/Linux)
-
-iQIVAwUBSQgMCRjmZ/HrivMUAQI2Jg//bZoSxx0Nor6uBikRGHQny8LzgUT/0kpv
-xg0eRmL9kQwhGis/sdOiJ9cHykJ1ukhRiIZGfxPBdxiQbWGs9nM6147TGIDgqx6D
-yYIW41dvzTRB0TwjNd7g1q6MaSiDNuU/6dD+ooM3/IiR8PDR7X8we0WhSM63KD+v
-HeMsN51UMhBfeaZ06fxrjYoJCvnp0YNYJpLuvtd5tzxqJCJA2Vh5VqJMbMP/MtbY
-zM/zuNXRI1mJnQZeU++IaAnimX7c7SsGjLaloZG8mapYqqY0tKJ5Yod6aeloq+i5
-wI4gZuuPcgAntD6cnPaqB1ni/d71yywme5F75zpezXGzKzDSh1J5oE6akjMi2lJE
-DSOKp7zb7TvDwXxCl+vOVod81F260gPhonlTsD/LpBfPGPBdWlWP+fFchb9N/a2u
-weCMhUYX1u8Jg/bHIycjoQjPEgZwCkJT9RKF1NTLyWvb4P4a3sPe+fauCMZFbTQ/
-3EYPRBY+PfIDO09XswdB5O3gq6B33ChyWJpdwlXEEHMcFt1FuezuP0avVM9/3ZNp
-MkqalDrUEd65X8o+CE3KjFxjMceVdda9mz2netnoHrFMW6X3mFqE2fTldgHi1mCT
-hMCqpPzY04+HOHYZ0GapR3pvedd4dwhkNYrdpckp+nJMTRfexEPH/NXDVNH/mxKg
-jLoIos0SaiY=
-=VUsz
+Version: GnuPG v1.4.10 (GNU/Linux)
+
+iQIVAwUBS0vWxBjmZ/HrivMUAQpXuQ/8CilKg4Va3BnBvieiBR4g3LCIxpgCwOgL
+t4HdVw3M3Ip20qfCXCb4Y/COCX173VEasrCtpdfaCVIUiOLRPaPA1dV7Czk8Ql9s
+WCRzhg/a/cF3jA4co90Vce1fDQjiZH+5hQyLA628Kza/eyL0ZW5DJsG3JqRhmEC/
+NRjXiVRnHOrptf8fp3NelbC63/BX7noANr1NjRSWhlzUc4ETd2AS6xrvaP66L+yt
+znJaAJwZE11G6GvUJbsmdJOeGzVb1rLjwzu5EvNs+en9XqNn+fjC5aYrMDiypuVA
+aJUTuSqsyCw0uRGlfa9dHc+FKfEjuPCZ/nUuC/DNY4e7FeOW8EHpLD8Rf+bZG0WV
+GyCPozP3sDAq+MOygergBV1fUKb95aJks+CdScFElVMsSL6KZFFPJF+5e1Vvl4ka
+Kb2u90p7DChugAblVFfsDlJBtjVUMG1w2+zoghZir6htHhbyrQi3bpZLyRMMyZgr
+0xglI8HjXVafUUOkM2sssIFXx2/yi9ymE+WcpbH5eSOn0uzpbtltT6rZeb9TCasC
+ekhX21e0vkDyVaFQSzQckrLQYwo1MaPOJO0jihdluFa2BRGzzVMs+1r0zlmO6RKE
+RcLIzL66Pnf56qTwBWgBhi2meKcdzFjdYChlAhdgwiMtbaKjceec1mqNQY6Yn0ke
+Og7cZUTa39U=
+=E7NZ
 -----END PGP SIGNATURE-----
 </pre>