add some rough instructions on getting the extension/perl validation agent going...
[monkeysphere.git] / website / download.mdwn
1 [[!meta title="Download"]]
2
3 # Downloading and Installing #
4
5 Once you've installed the packages, please see the [documentation
6 page](/doc) to read up on how to get started [as a regular
7 user](/getting-started-user) or [as a systems
8 administrator](/getting-started-admin).
9
10 ## Dependencies ##
11
12 Monkeysphere relies on:
13
14  * [OpenSSH](http://openssh.com/)
15  * [GnuPG](http://gnupg.org/)
16  * [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)
17
18 ## Firefox (or Iceweasel) ##
19
20 To use the Monkeysphere for website validation, you will need the
21 Firefox (Iceweasel) add-on, the monkeysphere package and the
22 validation agent. 
23
24 [Download and install the Firefox (Iceweasel)
25 add-on](http://archive.monkeysphere.info/monkeysphere.xul)
26
27 Once you have installed the add-on, you will need to restart your
28 browser, and then proceed to install the monkeysphere package and
29 validation agent below.
30
31 ## Debian ##
32
33 If you are running a [Debian](http://www.debian.org/) system, the
34 [monkeysphere is available in the Debian archive](http://packages.debian.org/search?keywords=monkeysphere&searchon=names&section=all&suite=all)
35
36 If you are running Debian unstable or testing install the latest monkeysphere
37 version as follows:
38
39     aptitude install monkeysphere
40
41 If you are running Debian stable, you can get the monkeysphere package
42 from [backports.org](http://backports.org/dokuwiki/doku.php?id=instructions)
43
44 To get started using the Monkeysphere for website validation, you will
45 need to install the Monkeysphere Validation Agent. Currently the perl
46 version of the agent is available in Debian sid, or directly from our
47 APT repository (see below):
48
49     aptitude install msva-perl
50
51 ## Debian derivatives (including Ubuntu) ##
52
53 You can also install the Monkeysphere directly from the Monkeysphere
54 APT repository.  You can add this archive to your system by putting
55 the following lines in `/etc/apt/sources.list.d/monkeysphere.list`:
56
57     deb http://archive.monkeysphere.info/debian experimental monkeysphere
58     deb-src http://archive.monkeysphere.info/debian experimental monkeysphere
59
60 The repository is currently signed by [The Monkeysphere archive
61 signing key](/archive-key), key id EB8AF314 (fingerprint: `2E8D D26C
62 53F1 197D DF40 3E61 18E6 67F1 EB8A F314`).  To cryptographically
63 verify the packages, you'll want to [add this key to your apt
64 configuration after verifying its integrity](/archive-key).
65
66 Note: Ubuntu shipped Monkeysphere 0.22 in their "Jaunty Jackalope"
67 release (9.04).  The Monkeysphere developers think that [Ubuntu
68 shipping Monkeysphere 0.22-1 is a bad
69 idea](https://bugs.launchpad.net/ubuntu/+source/monkeysphere/+bug/345054).
70 If you are an Ubuntu user, we would prefer that you install from the
71 APT archive above rather than run 0.22, which we no longer consider
72 supported.
73
74 Ubuntu users running "Karmic Koala" (9.10) or later should see version
75 0.26-1 or later in the standard Ubuntu universe repository, so please
76 use the regular Ubuntu repositories if you're running Karmic or later.
77
78 ## FreeBSD ##
79
80 There is [a FreeBSD port
81 available](http://www.freebsd.org/cgi/ports.cgi?query=monkeysphere)
82 for the Monkeysphere, built and tested against FreeBSD 7.1.
83
84 You should be able to build and install the latest port with:
85
86     cd /usr/ports/security/monkeysphere
87     make package
88
89 Enjoy!
90
91 ## Slackware ##
92
93 Silvio Rhatto has made [a SlackBuild
94 script](http://slack.sarava.org/slackbuilds/net/misc/monkeysphere/)
95 for the Monkeysphere, tested against Slackware 12.2.
96
97 This is generated by [the mkbuild system](http://simplepkg.sarava.org)
98 from [its .mkbuild
99 source](http://slack.sarava.org/mkbuilds/net/misc/monkeysphere/).
100
101 Thanks, rhatto!
102
103 ## Source ##
104
105 For those that would like to download the source directly, [the source
106 is available](/community) via [git](http://git.or.cz/).
107
108 The [latest
109 tarball](http://archive.monkeysphere.info/debian/pool/monkeysphere/m/monkeysphere/monkeysphere_0.29.orig.tar.gz)
110 is also available, and has these checksums:
111
112 <pre>
113 -----BEGIN PGP SIGNED MESSAGE-----
114 Hash: SHA512
115
116 checksums for the monkeysphere 0.29 release:
117
118 MD5:
119 009e26cc77d38e25697cdea06eecd5ab  monkeysphere_0.29.orig.tar.gz
120
121 SHA1:
122 db1074d6c5f424859ddec31cff0a0b6214789f16  monkeysphere_0.29.orig.tar.gz
123
124 SHA256:
125 0e3c683b7d8a07e6ceae80cb0d3acf647c3f8c74cbaab527f73608dcdd1b01fb  monkeysphere_0.29.orig.tar.gz
126 -----BEGIN PGP SIGNATURE-----
127 Version: GnuPG v1.4.10 (GNU/Linux)
128
129 iQIVAwUBS52/UhjmZ/HrivMUAQr98g/7B+6CCN9vrJFNZp2KX+jTcxBLRxY/2cJp
130 fIjtaNzoyr86Q6gXzsgavB6E+olqhM3YR2gy6Z+fzNe8CdI74ikFCb0b8JpbzU6a
131 F5et7RqQ/pkQrCawrVPTZnompqfJrWBPYZU5is85SJgX4jJrgUFrGbvTq2PsJDbC
132 w9H8oOxELmCGYUAxRYGcQKdhQTBoRYz0a7/DzKt4sQHYbNblO1T2YNuqBxn372Wp
133 bd8xholyfO6EjCfoEJPee8Uf1sxE4nhsYFYIHsuckqLbcdoE8crAmjeDdDt+yVCO
134 N35Y/SRKNbIe/Nj8NSwAobd8N2DWj1qBWtHbT8Mw5kyd65kRPnfTQII5W0/3m3rT
135 DwcXGsMMfOsPEMtAYfmGOaIdEH9y2O7tmV1Om2CGx0AV9F9F3RnyNlYB6mfVaUVO
136 fZOJuUU61FoGRYCb/R4DF0IdFUhy0yMgTgT5tAYGMFpHd5ZTYgzIAWrIbV7QhrHs
137 9LgrnJYffScHjjsE6NjjvOZQe9RrI25ZLHZEMo/zhZEMMzdIne8IZUXvz68v1wN9
138 mLcGRMG8B1CT4gXyi1uy1he7Zw0Hmz2Kbq619alRmyV8CqNhNrvMQicRqklKvcuW
139 mwKQx+bOxpwZgW4/46EDHJ4nUOaGjVXIwoDdisvKU5jDIMZBXB4lLJtPNFFsv18D
140 AxOLE3KlzF0=
141 =372c
142 -----END PGP SIGNATURE-----
143 </pre>