From 506c70eb951b7aa18d009fc4fc77ce2f20a6ffe8 Mon Sep 17 00:00:00 2001 From: Micah Anderson Date: Wed, 3 Jul 2013 11:39:17 -0400 Subject: Update README to guide a user through a basic understanding, and where to go next to get started or report problems Change-Id: I254e73db7bdbf181bd993d2e9d73e864a62d1112 --- README.md | 67 +++++++++++++++++++++++++-------------------------------------- 1 file changed, 27 insertions(+), 40 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 03e3cb80..5e9600cd 100644 --- a/README.md +++ b/README.md @@ -5,43 +5,39 @@ 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 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 set of complementary packages and server recipes to automate the maintenance of LEAP services in a hardened Debian environment. Its goal is to make it as painless as possible for sysadmins to deploy and maintain a service provider’s infrastructure for secure communication. These recipes define an abstract service provider. It is a set of Puppet modules designed to work together to provide to sysadmins everything they need to manage a service provider infrastructure that provides secure communication services. -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. +As these recipes consist of abstract definitions, in order to configure settings for a particular service provider a system administrator has to obtain the leap command-line interface and create a provider instance. The details of how to get started are contained in the `Quick Start` documentation as detailed below. -Documentation -============= -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. +Getting started +=============== -Requirements -============ +It is highly recommended that you start by reading the overview of the Leap Platform on the website (https://leap.se/docs/platform) and then begin with the `Quick Start` guide (https://leap.se/docs/platform/quick-start) to walk through a test environment setup to get familiar with how things work before deploying to live servers. -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. +An offline copy of this documentation is contained in the `doc` subdirectory. For more current updates to the documentation, visit the website. -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 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. +Requirements +------------ -Usage -===== +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. If you follow the `Quick Start` documentation we will walk you through using Vagrant to setup a test deployment. -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 +For a live deployment of the platform the amount of required (virtual) servers depends on your needs and which services you want to deploy. At the moment, the Leap Platform supports servers with a base Debian Wheezy installation. -We strongly recommend to follow the `Quick Start` Documentaion which can be found on the website https://leap.se +While you can deploy all services on one server, we stronly recommend to use seperate servers for better security. -Clone leap_platform and its submodules --------------------------------------- +Troubleshooting +=============== - git checkout develop +If you have a problem, we are interested in fixing it! The best way for us to solve your problem is if you provide to us the complete log of what you did, and the output that was produced. Please don't cut out what appears to be useless information and only include the error that you received, instead copy and paste the complete log so that we can better determine the overall situation. -Initialize Submodules: +Visit https://leap.se/en/development for contact possibilities. - git submodule update --init +Known bugs +---------- + +* Please read the section in the documentation about Known Issues (https://leap.se/docs/known-issues) More Information @@ -49,23 +45,6 @@ More Information For more information about the LEAP Encryption Access Project, please visit the website https://leap.se which also lists contact data. - -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 --------- @@ -80,3 +59,11 @@ See contributors: git shortlog -es --all + +Copyright/License +----------------- + +Read LICENSE + + + -- cgit v1.2.3