summaryrefslogtreecommitdiff
path: root/doc/troubleshooting/vagrant.md
diff options
context:
space:
mode:
authorMicah Anderson <micah@leap.se>2015-06-11 10:36:16 -0400
committerMicah Anderson <micah@leap.se>2015-06-11 10:36:16 -0400
commit49513b828f019a0eb7c6f5082f6e9d817136904a (patch)
tree16de1ce8a4859c3c14fdc280446502caf6b368cc /doc/troubleshooting/vagrant.md
parent18e247ae29e7ee787e350724e2884da0a74bbd63 (diff)
update /doc dir with latest from leap docs/platform
Change-Id: If4bcf7e2139b672c3e38f55e54d1f121a5601860
Diffstat (limited to 'doc/troubleshooting/vagrant.md')
-rw-r--r--doc/troubleshooting/vagrant.md45
1 files changed, 45 insertions, 0 deletions
diff --git a/doc/troubleshooting/vagrant.md b/doc/troubleshooting/vagrant.md
new file mode 100644
index 00000000..ad284161
--- /dev/null
+++ b/doc/troubleshooting/vagrant.md
@@ -0,0 +1,45 @@
+@title = 'LEAP Platform Vagrant testing'
+@nav_title = 'Vagrant Integration'
+@summary = 'Testing your provider with Vagrant'
+
+Setting up Vagrant for a testing the platform
+=============================================
+
+There are two ways you can setup leap platform using vagrant.
+
+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.
+
+Clone the platform with
+
+ git clone https://github.com/leapcode/leap_platform.git
+
+Start the vagrant box with
+
+ cd leap_platform
+ 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`
+
+
+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-email how
+to setup a single node mail server.
+
+