summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorvarac <varacanero@zeromail.org>2015-01-02 19:49:19 +0100
committervarac <varacanero@zeromail.org>2015-01-02 19:49:19 +0100
commitfe0d25643414bc693cb197a4045116663f00d5e5 (patch)
treeefb5efa275e7b78c467a73b6cca25e2f16da5cac
parentd91f96292e7123b17b37950d32a78838685b7f28 (diff)
fixed navigation
-rw-r--r--docs/platform/tutorials/quick-start.md75
-rw-r--r--docs/platform/tutorials/single-node-vpn.md4
2 files changed, 77 insertions, 2 deletions
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