guides/user/Installation.md

+# Installation instructions
+
+## v0.4.1
+
+Arachni will run in any *nix environment (including Cygwin for Windows users)
+that satisfies the following dependencies:
+
+* ruby1.9.2 (or higher)
+* libsqlite3-devel
+* libsql3.0
+* libffi4
+* gcc4
+* gcc4-core
+* gcc4-g++
+* libxml2-devel
+* make
+* openssl-devel
+* pkg-config
+* libxslt
+* libxslt-devel
+* libopenssl098
+* libxml2
+* libmpfr4
+* libcurl-devel
+* libcurl4
+* libyaml-devel
+* yaml
+
+**Packages per platform:**
+
+* [*nix](#nix)
+    * [Gem](#nix-gem)
+    * [Source](#nix-source)
+* [Linux](#linux)
+* [OSX](#osx)
+* [Windows -- under Cygwin](#windows)
+    * [Pre-configured installation](#windows-preconfigured)
+    * [Manual installation](#windows-manual)
+
+## <a id="nix" href="#nix">*nix</a>
+
+To work with the source of install the Gem you'll need the aforementioned dependencies.
+
+Users of Debian-based distributions can run the following to install them:
+
+    sudo apt-get install build-essential libxml2-dev libxslt1-dev libcurl4-openssl-dev libsqlite3-dev libyaml-dev zlib1g-dev ruby1.9.1-dev ruby1.9.1
+
+### <a id="nix-gem" href="#nix-gem">Gem</a>
+
+To install Arachni:
+
+    sudo gem install arachni
+
+### <a id="nix-source" href="#nix-source">Source</a>
+
+If you want to clone the repository and work with the source code then you'll need to run the following to install all gem dependencies and Arachni:
+
+    git clone git://github.com/Arachni/arachni.git
+    cd arachni
+    sudo gem install bundler
+    bundle install    # to resolve possible dev dependencies
+    sudo rake install # to install to PATH
+
+## <a id="linux" href="#linux">Linux</a>
+
+Linux users can download the latest self-contained archive for their system from the
+website's [download](http://arachni-scanner.gr/latest) page.
+
+## <a id="osx" href="#osx">Mac OSX</a>
+
+OSX users can download the latest self-contained archive for their system from the
+website's [download](http://arachni-scanner.gr/latest) page.
+
+## <a id="windows" href="#windows">Windows -- under Cygwin</a>
+
+### <a id="windows-preconfigured" href="#windows-preconfigured">Pre-configured installation</a>
+
+All you need to do is download the [latest self-extracting archive](http://arachni-scanner.gr/latest),
+run it, select a directory under which to extract it, open it up and then
+execute the <em>Cygwin</em> batch file.
+
+You will then be presented with a Bash shell, after that you'll be able to use
+Arachni as if you were on a Linux system.
+
+### <a id="windows-manual" href="#windows-manual">Manual installation</a>
+
+[Download Cygwin's setup file](http://cygwin.com/setup.exe), open up a terminal,
+move to the directory of ```setup.exe``` and issue:
+
+    setup.exe -q -R c:\cygwin -l c:\cygwin-packages -P libsqlite3-devel,libsql3_0,libffi4,gcc4,gcc4-core,gcc4-g++,libxml2-devel,make,openssl-devel,pkg-config,git,libxslt,libxslt-devel,libopenssl098,tcltk,libxml2,libmpfr4,libcurl-devel,libcurl,ruby,libyaml-devel,libyaml0_2,yaml
+
+Choose your preferred download mirror and the directory in which to save the
+downloaded packages for future use, click next during package selection
+and wait for the setup to finish.
+
+Once that's done, open up the Cygwin shell and run:
+
+    git clone git://github.com/djberg96/sys-proctable.git
+    cd sys-proctable
+    mkdir -p /usr/lib/ruby/site_ruby/1.9.1/sys
+    rake install
+    gem build sys-proctable.gemspec
+    gem install sys-proctable-0.9.1-x86-cygwin.gem # adjust the version number
+
+    gem install arachni
+
+And you're good to go. :)