From fe0d25643414bc693cb197a4045116663f00d5e5 Mon Sep 17 00:00:00 2001 From: varac Date: Fri, 2 Jan 2015 19:49:19 +0100 Subject: fixed navigation --- docs/platform/tutorials/quick-start.md | 75 ++++++++++++++++++++++++++++++ docs/platform/tutorials/single-node-vpn.md | 4 +- 2 files changed, 77 insertions(+), 2 deletions(-) create mode 100644 docs/platform/tutorials/quick-start.md diff --git a/docs/platform/tutorials/quick-start.md b/docs/platform/tutorials/quick-start.md new file mode 100644 index 0000000..9051f03 --- /dev/null +++ b/docs/platform/tutorials/quick-start.md @@ -0,0 +1,75 @@ +@title = 'LEAP Platform quick start tutorial' +@nav_title = 'Quick Start' +@summary = 'Getting leap platform up, the quick way' + + +Testing Leap platform with Vagrant +================================== + +There are two ways how you can setup leap platform +using vagrant. + +Use the leap_cli vagrant integration +==================================== + +Install leap_cli and leap_platform on your host, +configure a provider from scratch and use the +`leap local` commands to manage your vagrant node(s). + +See https://leap.se/en/docs/platform/development how to use +the leap_cli vagrant integration and +https://leap.se/en/docs/platform/tutorials/single-node how +to setup a single node mail server. + + +Using the Vagrantfile provided by Leap Platform +=============================================== + +This is by far the easiest way. +It will install a single node mail Server in the default +configuration with one single command. + +Start the vagrant box with + + vagrant up + +Follow the instructions how to configure your `/etc/hosts` +in order to use the provider! + +You can login via ssh with the systemuser `vagrant` and the same password. + +There are 2 users preconfigured: + +. `testuser` with pw `hallo123` +. `testadmin` with pw `hallo123` + + +Using the bitmask client +======================== + +Download the provider ca: + + wget --no-check-certificate https://example.org/ca.crt -O /tmp/ca.crt + +Start bitmask: + + bitmask --ca-cert-file /tmp/ca.crt + + + +Recieving Mail +-------------- + +Use i.e. swaks to send a testmail + + swaks -f noone@example.org -t testuser@example.org -s example.org + +and use + + offlineimap -c vagrant/.offlineimaprc.example.org + +to fetch it. +WARNING: Use offlineimap *only* for testing/debugging, +because it will save the mails *decrypted* locally to +your disk ! + diff --git a/docs/platform/tutorials/single-node-vpn.md b/docs/platform/tutorials/single-node-vpn.md index f45574d..0e3d486 100644 --- a/docs/platform/tutorials/single-node-vpn.md +++ b/docs/platform/tutorials/single-node-vpn.md @@ -1,5 +1,5 @@ -@title = 'LEAP Platform Quick Start' -@nav_title = 'Quick Start' +@title = 'Single node VPN tutorial' +@nav_title = 'Single node VPN' @summary = 'Three node OpenVPN provider.' Quick Start -- cgit v1.2.3