From 89638cd3e9a29a126c660eea3b40179c67e87d69 Mon Sep 17 00:00:00 2001 From: Kwadronaut Date: Wed, 24 Oct 2012 15:13:42 +0200 Subject: Adding getting started content, needs more cleanup --- README.md | 76 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 76 insertions(+) diff --git a/README.md b/README.md index 6be733cb..9dc3470e 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,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 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 + +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 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, DNS, CouchDB and a webapp to administer your users (billing, help tickets,...). + +To get started you will need to have git, ruby1.8, rails, rubygems, bundler, ruby1.8-dev, libgpgme-ruby. + +Configuration +------------- +Edit config/ + + +Installation +------------ + +- Edit /etc/leap/hieradata/common.yaml for your needs +- Run the deploy.sh script as root + +git clone ssh://gitolite@leap.se/leap_platform +git clone ssh://gitolite@leap.se/leap_cli + + cd leap_cli + + bundle + + cd .. + +git clone ssh://gitolite@leap.se/leap_testprovider +ln -s /home/me/dev/leap_cli/bin ~/bin # or whatever to have leap_cli/bin/leap in your path. +cd leap_testprovider +ln -s ../leap_platform . +cd leap_testprovider/provider +leap help +leap clean +leap compile +leap add-user --self + +More Information +---------------- +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 +---------- + +Troubleshooting +--------------- + +Changelog +--------- + + +Authors and Credits +------------------ + +a file manifest + -- cgit v1.2.3 From 3d1f78aa16b8bc1c37324a2a1c652615678175f0 Mon Sep 17 00:00:00 2001 From: varac Date: Thu, 25 Oct 2012 09:39:49 +0200 Subject: moved to develop --- README.md | 76 --------------------------------------------------------------- 1 file changed, 76 deletions(-) diff --git a/README.md b/README.md index 9dc3470e..6be733cb 100644 --- a/README.md +++ b/README.md @@ -1,79 +1,3 @@ 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 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 - -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 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, DNS, CouchDB and a webapp to administer your users (billing, help tickets,...). - -To get started you will need to have git, ruby1.8, rails, rubygems, bundler, ruby1.8-dev, libgpgme-ruby. - -Configuration -------------- -Edit config/ - - -Installation ------------- - -- Edit /etc/leap/hieradata/common.yaml for your needs -- Run the deploy.sh script as root - -git clone ssh://gitolite@leap.se/leap_platform -git clone ssh://gitolite@leap.se/leap_cli - - cd leap_cli - - bundle - - cd .. - -git clone ssh://gitolite@leap.se/leap_testprovider -ln -s /home/me/dev/leap_cli/bin ~/bin # or whatever to have leap_cli/bin/leap in your path. -cd leap_testprovider -ln -s ../leap_platform . -cd leap_testprovider/provider -leap help -leap clean -leap compile -leap add-user --self - -More Information ----------------- -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 ----------- - -Troubleshooting ---------------- - -Changelog ---------- - - -Authors and Credits ------------------- - -a file manifest - -- cgit v1.2.3 From 5b60283e067e0a445b171cc31e4284487415c4d6 Mon Sep 17 00:00:00 2001 From: varac Date: Tue, 6 Nov 2012 14:05:12 +0100 Subject: updated README.md --- README.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/README.md b/README.md index 6be733cb..16cc34ef 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,6 @@ Leap Platform ============= +... still under development, see README.md in the develop branch for details. + +Stay tuned ! -- cgit v1.2.3