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