summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFelix Hammerl <felix.hammerl@gmail.com>2016-02-10 18:04:47 +0100
committerFelix Hammerl <felix.hammerl@gmail.com>2016-02-10 18:04:47 +0100
commit55a9bf2e4b4dd33bb736fc698b598c37e342f551 (patch)
tree40df5ffcc941ae82a60fbc54d5e71fe7df721523
parent36e9187e342511a026dbdc8e0ac3f64ab8f4fbe2 (diff)
Add virtualenv and GPG workaround to guide
-rw-r--r--README.md28
1 files changed, 20 insertions, 8 deletions
diff --git a/README.md b/README.md
index 2abf95b3..832a3dcd 100644
--- a/README.md
+++ b/README.md
@@ -26,22 +26,34 @@ $ cd pixelated-user-agent
$ vagrant up
```
-4) Log into the VM:
+4) Set up your python virtualenv
+
+```
+$ pip install virtualenv setuptools
+$ cd ~
+$ virtualenv pixelated
+$ virtualenv -p [PATH/TO/YOUR/PYTHON/EXECUTABLE] pixelated
+$ source ~/.virtualenv/pixelated/bin/activate
+```
+
+5) There's a bug in a LEAP library that can't handle symlinks to your local GPG installation. To fix it, add the path to your GPG binary to your $PATH so that it is found before the symlink in `/usr/local/bin` (or similar)
+
+6) Log into the VM:
```
$ vagrant ssh
```
-5) Setup the project (downloads a few hundred more megabytes):
+7) Setup the project (downloads a few hundred more megabytes):
```
$ cd /vagrant/service
$ ./go setup
```
-6) Register with a LEAP provider. You can create a developer account at our [Dev Provider](https://dev.pixelated-project.org/). Please contact us at team@pixelated-project.org for an invite code.
+8) Register with a LEAP provider. You can create a developer account at our [Dev Provider](https://dev.pixelated-project.org/). Please contact us at team@pixelated-project.org for an invite code.
-7) Run the user agent:
+9) Run the user agent:
```
$ pixelated-user-agent --host 0.0.0.0
@@ -56,11 +68,11 @@ Type your password:
******** (the one you created in previous step)
```
-8) Connect to the provider using your credentials. If the user agent starts up successfully, you will not see any other output.
+10) Connect to the provider using your credentials. If the user agent starts up successfully, you will not see any other output.
-9) Go to [localhost:3333](http://localhost:3333/). You should see a loading screen for a few seconds, then your inbox. If it sticks on the loading screen, check your terminal for errors, then [get help](https://pixelated-project.org/faq/#contact-the-project).
+11) Go to [localhost:3333](http://localhost:3333/). You should see a loading screen for a few seconds, then your inbox. If it sticks on the loading screen, check your terminal for errors, then [get help](https://pixelated-project.org/faq/#contact-the-project).
-10) If you like console output, you can also run the tests to see if everything went according to plan.
+12) If you like console output, you can also run the tests to see if everything went according to plan.
To run the backend tests:
@@ -83,7 +95,7 @@ To run the functional tests:
(user-agent-venv)vagrant@jessie:/vagrant/service$ ./go functional
```
-11. You're all set! We've prepared [a couple of issues labeled "Beginner"](https://github.com/pixelated/pixelated-user-agent/issues?utf8=%E2%9C%93&q=is%3Aopen+is%3Aissue+label%3ABeginners+) that are a good place to dive into the project. Happy Hacking!
+13) You're all set! We've prepared [a couple of issues labeled "Beginner"](https://github.com/pixelated/pixelated-user-agent/issues?utf8=%E2%9C%93&q=is%3Aopen+is%3Aissue+label%3ABeginners+) that are a good place to dive into the project. Happy Hacking!
# Further Notes