summaryrefslogtreecommitdiff
path: root/docs/dev/quickstart.rst
diff options
context:
space:
mode:
authorIvan Alejandro <ivanalejandro0@gmail.com>2013-10-22 14:35:41 -0300
committerIvan Alejandro <ivanalejandro0@gmail.com>2013-10-22 14:35:41 -0300
commite149f7e3e6a5c4621edd252fd7f75c580c5e49b3 (patch)
tree137e7854818f25d52591b5a2b96f64bba414cb8b /docs/dev/quickstart.rst
parentc5da232623fb8322ab66f79fe823d16600be0090 (diff)
parente4ede90a3e20bd9b023fed12d6d72db3fcc380ab (diff)
Merge remote-tracking branch 'kali/feature/quickstart-and-deps' into develop
Diffstat (limited to 'docs/dev/quickstart.rst')
-rw-r--r--docs/dev/quickstart.rst82
1 files changed, 82 insertions, 0 deletions
diff --git a/docs/dev/quickstart.rst b/docs/dev/quickstart.rst
new file mode 100644
index 00000000..8ef7dfb8
--- /dev/null
+++ b/docs/dev/quickstart.rst
@@ -0,0 +1,82 @@
+.. _quickstart:
+
+Quickstart
+==========
+
+**Assumptions:** These instructions were made on a clean Ubuntu 12.04.3
+system.
+
+**Goal:** With minimal effort or reading install the necessary packages
+to build the latest development code for ``bitmask_client``
+
+**Outcome:** At the end of these instructions, you should be able to run
+the latest development branch for bitmask client, getting the GUI in debug
+mode and connect to a LEAP provider (bitmask.net)
+
+If you want to know what each step is for, check
+:ref:`this other section <environment>`.
+
+
+Prerequisites
+-------------
+
+.. begin-debian-deps
+::
+
+ $ sudo apt-get install git python-dev python-setuptools
+ python-virtualenv python-pip python-openssl libsqlite3-dev g++ openvpn
+ pyside-tools python-pyside
+
+.. python-qt4 ??? (for translations)
+.. TODO I'm pretty sure python-qt4 shoudln't be there...
+ Nor libsqlite-dev, that's a bug in python-sqlcipher/soledad.
+
+
+.. XXX any change HERE ^^^^ should be reflected also in README.rst.
+ From any other place in the documentation, it should be just included.
+
+.. end-debian-deps
+
+Clone the repo into your working directory, and checkout development branch::
+
+ $ git clone https://github.com/leapcode/bitmask_client bitmask
+ $ cd bitmask
+ $ git checkout develop
+
+
+Create and activate the virtualenv, and symlink to your gloabal PySide install::
+
+ $ virtualenv .
+ $ source bin/activate
+ (bitmask)$ pkg/postmkvenv.sh
+
+
+Python libraries
+----------------
+
+Install the bitmask package in development mode inside the virtualenv. This will
+also install the needed dependencies::
+
+ (bitmask)$ python2 setup.py develop
+
+Compile the resource files::
+
+ (bitmask)$ make resources
+
+Copy necessary files into system folders, with root privileges::
+
+ (bitmask)$ sudo mkdir -p /etc/leap
+ (bitmask)$ sudo cp pkg/linux/resolv-update /etc/leap
+ (bitmask)$ sudo cp pkg/linux/polkit/net.openvpn.gui.leap.policy /usr/share/polkit-1/actions/
+
+
+Running
+--------
+
+Run ``bitmask_client`` in debug mode::
+
+ (bitmask)$ bitmask --debug
+
+You should see the ``bitmask_client`` window prompting to connect to an
+existing node or add a new one. If not, something went wrong, maybe ask
+on #leap-dev at irc.freenode.net