From e6bef48157c7f4d681028ac881ab62ff35041909 Mon Sep 17 00:00:00 2001
From: pierreozoux <pierre@ozoux.net>
Date: Thu, 11 Feb 2016 11:30:19 +0000
Subject: [PATCH] Install instructions \o/

---
 .gitignore |  2 --
 README.md  | 70 ++++++++++++++++++++++++++++--------------------------
 2 files changed, 36 insertions(+), 36 deletions(-)

diff --git a/.gitignore b/.gitignore
index 519fa87..1377554 100644
--- a/.gitignore
+++ b/.gitignore
@@ -1,3 +1 @@
-.vagrant
-docker-haproxy-confd
 *.swp
diff --git a/README.md b/README.md
index e36cc3f..dc2fc74 100644
--- a/README.md
+++ b/README.md
@@ -1,49 +1,51 @@
-## IndieHosters
+# LibrePaaS
 
-This repository contains the configuration and scripts I use to control my servers.
+## Introduction
 
-### Tests
+A PaaS that is aimed at hosting free software \o/
 
-There is a script that provision 2 VMs on Vutlr for tests purpose.
+To install it, follow instructions in `INSTALL.nd`.
 
-#### Prerequisites
+## Modular
 
- - have a [vultr account](http://www.vultr.com/?ref=6810586)
- - have a [VULTR API KEY](https://my.vultr.com/settings/)
- - have the [port 25 open](https://www.vultr.com/docs/what-ports-are-blocked) (if you want to test emails)
- - have an [ssh key registered](https://my.vultr.com/sshkeys/)
+The PaaS is really modular, that's why it contains the strict necessary, then you'll probably want to add `system` modules or `applications`.
 
-#### Start tests
+## System modules
 
-/!\ This is still in dev, use it at your own risk /!\
+Here is a list of modules supported:
+ - haproxy
+ - git-puller
+ - backups
+Go to their respective page for more details.
+
+To install and start a module:
+
+```
+git clone module /system/
+systemctl enable s@module
+systemctl start s@module
+```
+
+## Application modules
+
+To install application `wordpress` on `example.org`, just run:
 
 ```
-export VULTR_API_KEY=
-./scripts/start.sh
-ssh root@server.test
-cd /data/indiehosters
-./tests/start.sh
-./tests/email.sh
-reboot
-ssh root@server.test
-./tests/stop.sh
-# find out WordPress password:
-journalctl -u web@*.test | grep to\ connect\ test
-# find out piwik and owncloud password:
-journalctl -u web@*.test | grep \'\>\>\ generated
-exit
-./scripts/stop.sh
+provision -a github.com/indiehosters/wordpress -u example.org -s
 ```
 
-Most of the tests are "visual", but by reading them, it gives you an idea on how to start and stop services.
+Run `provision` for more details on the capabilities of the script.
 
-Before running `./scripts/stop.sh`, you can use your browser to see the applications:
+## Contributing
 
-* https://wordpress.test/ user: test@test.org pass: as found with journalctl before
-* https://owncloud.test/ user: test@test.org pass: as found with journalctl before
-* https://piwik.test/ user: test@test.org pass: as found with journalctl before
-* https://static.test/ (you will simply see the contents of server.test:/data/domains/static.test/static/www-content/index.html)
-* https://known.test/ (you will be able to create a user there)
+If you have any issue (something not working, mail marked as spam, missing doc), please do report an issue here! Thanks
 
-This is still work in progress, please feel free to contribute to it!
+This system is used in production at [IndieHosters](https://indiehosters.net/) so it is maintained. If you use it, please tell us, and we'll be really happy to update this README!
 
+You can help us by:
+ - starring this project
+ - sending us a thanks email
+ - reporting bugs
+ - writing documentation/blog on how you got up and running in 5mins
+ - writing more documentation
+ - sending us cake :) We loove cake!
-- 
GitLab