From c43bb848ab337ba59b34cdf7e754203935128eb7 Mon Sep 17 00:00:00 2001 From: varac Date: Fri, 8 Feb 2013 19:03:53 +0100 Subject: updated README, added LICENSE --- README.md | 97 +++++++++++++++++---------------------------------------------- 1 file changed, 26 insertions(+), 71 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index b7f07e27..c41e27c7 100644 --- a/README.md +++ b/README.md @@ -5,124 +5,79 @@ Leap Platform What is it? =========== -The LEAP Provider Platform is the server-side part of the LEAP Encryption Access Project that is run by service providers. It consists of a set of complementary packages and recipes to automate the maintenance of LEAP services in a hardened GNU/Linux environment. LEAP makes it easy and straightforward for service providers and ISPs to deploy a secure communications platform for their users. +The LEAP Provider Platform is the server-side part of the LEAP Encryption Access Project that is run by service providers. It consists of a set of complementary modules and recipes to automate the maintenance of LEAP services in a hardened GNU/Linux environment. LEAP makes it easy and straightforward for service providers and ISPs to deploy a secure communications platform for their users. The LEAP Platform is essentially a git repository of puppet recipes, with a few scripts to help with bootstrapping and deployment. A service provider who wants to deploy LEAP services will clone or fork this repository, edit the main configuration file to specify which services should run on which hosts, and run scripts to deploy this configuration. Documentation ============= -Most of the current documentation can be found in Readme files of the different pieces. Eventually this will be consolidated on the website https://leap.se +Most of the current documentation can be found in Readme files of the different pieces. This will be consolidated on the website https://leap.se soon. Requirements ============ This highly depends on your (expected) user base. -For a minimal test or develop install we recommend a fairly recent computer x86_64 with hardware virtualization features (AMD-V or VT-x) with plenty of RAM. You could use Vagrant or KVM to simulate a live deployment. +For a minimal test or develop install we recommend a fairly recent computer x86_64 with hardware virtualization features (AMD-V or VT-x) with plenty of RAM. +You could use Vagrant or KVM to simulate a live deployment. For a live deployment of the platform the amount of required (virtual) servers depends on your needs and which services you want to deploy. -In it's initial release you can deploy OpenVPN, CouchDB and a webapp to administer your users (billing, help tickets,...). +In it's initial release you can deploy Tor, OpenVPN, CouchDB and a webapp to administer your users (billing, help tickets,...). While you can deploy all services on one server, we stronly recommend to use seperate servers for better security. -To get started you will need to have git, ruby1.8, rails, rubygems, bundler, ruby1.8-dev, libgpgme-ruby. +Usage +===== -Installation -============ - -Create a working directory --------------------------- - - mkdir ~/Leap - cd ~/Leap - -Install leap_cli ----------------- - - git clone git://code.leap.se/leap_cli - cd leap_cli - -See also README.md for installation hints, but this should work in most cases: - - bundle - rake build - rake install - leap help - this should provide you with the help output of the leap command-line tool - -Install leap_platform ---------------------- - - cd ~/Leap - git clone git://code.leap.se/leap_platform - cd leap_platform - -Right now, use the develop branch - - git checkout develop +As mentioned above, Leap Platform are the server-side Puppet manifests, for deploying a service provider, you need the leap command line interface, +available here: https://github.com/leapcode/leap_cli -Initialize Submodules +We strongly recommend to follow the `Quick Start` Documentaion which can be found on the website https://leap.se - git submodule update --init -Configuration -============= - -Create config file templates ----------------------------- +Clone leap_platform and its submodules +-------------------------------------- - cd ~/Leap - leap init-provider vagrant_test - cd vagrant_test + git checkout develop -Configure ---------- +Initialize Submodules: -Edit following files: - - * common.json - * nodes/.json - change to be the hostname of the server hosting couchdb - * nodes/.json - change to be the hostname of the server hosting the webapp - * nodes/.json - change to be the hostname of the server hosting the VPN server - - leap add-user --self - leap compile + git submodule update --init -Initialize and deploy nodes ---------------------------- - -For every server you configured do: - - leap init-node SERVERNAME - leap -v 2 deploy SERVERNAME More Information ----------------- -For more information about the LEAP Encryption Access Project, please visit the website https://leap.se which also lists contact data. +================ +For more information about the LEAP Encryption Access Project, please visit the website https://leap.se which also lists contact data. -Following needs to be written: Copyright/License ----------------- Read LICENSE + Known bugs ---------- +* currently none known, there will probably be some around ! + Troubleshooting --------------- +Visit https://leap.se/en/development for contact possibilities. + Changelog --------- For a changelog of the current branch: - cd ~/Leap - git log + git log Authors and Credits ------------------ -a file manifest +See contributors: + + git shortlog -es --all -- cgit v1.2.3