preparing 0.25 release
[monkeysphere.git] / website / download.mdwn
index 599e69545f880e5a73dbc7ec873aa1dbf46c87e6..508c5a8661b1c98567df93d7cbb3729cd1889bc1 100644 (file)
 
 # 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::SHA1](http://search.cpan.org/dist/Digest-SHA1/) 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).
+
+Note: Ubuntu appears to be planning to ship 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.
+
+## FreeBSD ##
+
+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.
+
+You should be able to build and install the latest port with:
 
-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).
+    cd /usr/ports/security/monkeysphere
+    make package
 
-## Enhancements ##
+Enjoy!
 
-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.
+## Slackware ##
 
-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:
+Silvio Rhatto has made [a SlackBuild
+script](http://slack.sarava.org/slackbuilds/net/misc/monkeysphere/)
+for the Monkeysphere, tested against Slackware 12.2.
 
-       deb http://archive.monkeysphere.info/debian experimental monkeysphere gnutls
-       deb-src http://archive.monkeysphere.info/debian experimental monkeysphere gnutls
+This is generated by [the mkbuild system](http://simplepkg.sarava.org)
+from [its .mkbuild
+source](http://slack.sarava.org/mkbuilds/net/misc/monkeysphere/).
 
-You can [read more about this offering](/news/modified-gnutls-2.4.x-available).
+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.25.orig.tar.gz)
+is also available, and has these checksums:
 
 <pre>
 -----BEGIN PGP SIGNED MESSAGE-----
-Hash: SHA1
+Hash: SHA512
 
-checksums for the monkeysphere 0.15 release:
+checksums for the monkeysphere 0.25 release:
 
 MD5:
-8be275e5b5119921a536d8a67d3bfe24  monkeysphere_0.15.orig.tar.gz
+aff67ae009c6f12fb65d05dba888e662  monkeysphere_0.25.orig.tar.gz
 
 SHA1:
-65da0a047d935e856e2a0d7032dbbb339a3ce20a  monkeysphere_0.15.orig.tar.gz
+aee1a84e3ac738eeb597a5debf35dfc0ab2c5d40  monkeysphere_0.25.orig.tar.gz
 
 SHA256:
-44f3feb6e9f6921d2ed0406af4e3862f67da9261c8f00c7ea37cfea5031cbc77  monkeysphere_0.15.orig.tar.gz
+6849b8b060215fe9959afe1b64a828e61e93661db998c5e128768be5cc7005ed  monkeysphere_0.25.orig.tar.gz
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.9 (GNU/Linux)
 
-iQIVAwUBSMG2fxjmZ/HrivMUAQJ40RAAjb4Rh9qJQztp+tAOxpvXKmItRTFyBTeB
-QQWjl/gNSWbAOvZX9t+F63P8Dp/ET9XoE2iXUnClvCtkkKvwbKISHyM4C9tgu0z9
-Yggb6lFPt/Qz2fD/HTMxkeN+n0p/FVjLW9WlLPyKF++u/o8JelyuiXocHORzjtc/
-9HyQfdbZuUPA16ZsAb9D66aIC2pWR21EiXHj95EvUkm6AO53Sy9G5gzzveflRrLm
-UdrcwCnbXiZklbs9wXxeZTa4qLAhv31RmkCzbE3/lNwFSBfzFFfi2HXZqQdRmIgu
-xuV/wmi8xgxUbv7dbB7yhhqwFmRnzeuV3rvuvSdjqGjFu6R0fqorIOtLtBkG1m0Q
-RP5gs5mU+DreYkdeLWpFFFVjaJkz0cNUcnT22EJ5JgfeH3fkoAPpjlUMvgh8apGq
-CbtqmBfYVOLyifiwptCSwlQvfY2guBVmsW+C60g78vMlCa0Tezp79I5H1KdsXKlY
-cw1eLt3HhEy39yojmcD5EI293tfWTIYvULXvMIZjqEFnkFvoAogtinfd8fDoH15j
-8yqXOUfkuuSeGmPReyiZZkbBTMXOdM6JsXmjEMI5T9dnZcC0CClnDGfcxE2UfPQZ
-v9tneWXZzFmnWaAqH+T+SJJ4gpMhD+i0vXgQ7xOhUUCF+tiY8Qh1eltR2Kf+VeYW
-d+MRglTs/Z4=
-=AmW6
+iQIVAwUBSl/fLxjmZ/HrivMUAQqhTBAAmAuS8jlrvIHa/Bp86V4Czz+qhi+w4s11
+V6AOZrGluT9IDWURaUucVkwrfGxsvWrZRbWqWTii0+f6JfN1dFQXzkMF8IGP3GA6
+/WuVrjI7h3LD8gU8WMfkK1DujTXkPanXNygGp6DMwfmmmZWPReYbatJMDmW8VmH5
+YvBNVYthqc3EZF7+hjJdiDSrPLzgKlRPnzOr37sNV4A56XblTBBwx7PL209lfjYg
+Yt/qQfAVoMcrY3FhgD7uXsq9G//cGEe7gzNncuhCyeKnVEevVv8KmYgEImeaRFNh
+EHrOg8kJJIO0CtHqNlElnMYSzrE47QPPmZMZuPfhuq+cDWiTgyZpEEt0ofcsflBD
+2fRpqmaXCIQkoU49KhRAKpknD4LKcjAokql/RMlYgHgeVsxLDwK1AJ1wCyamgSVE
+NjAAEj56+6GVLvyOD9ncwpx2bV8zZ4pK4SWGzuvSwtfHLP8JgE5Q+o+tVBNN2wxM
+ftNn2lCTwVuFDt504x1KevAzLiIKjLdeXfrTD7RaRBTZXnLQDqGZLZeUPJxa74nK
+5Iq/fJe5JktNNxiZ8OFYCZMkrrVya+rkp2q8/ftnQSLNgEs4wn+LedbiDMd1ZqiV
+YC63lPHpEo3fsxyX5RoU3KQhcbIR0Z/PSKZm/4TKCaUlVoISMJy/URp5lQkEXELc
+E4ZMSSKROOw=
+=uhFp
 -----END PGP SIGNATURE-----
 </pre>