README.md 1.33 KB
Newer Older
Pierre Ozoux's avatar
Pierre Ozoux committed
1
# LibrePaaS
2

Pierre Ozoux's avatar
Pierre Ozoux committed
3
## Introduction
4

Pierre Ozoux's avatar
Pierre Ozoux committed
5
A PaaS that is aimed at hosting free software \o/
Pierre Ozoux's avatar
Pierre Ozoux committed
6

Pierre Ozoux's avatar
Pierre Ozoux committed
7
To install it, follow instructions in `INSTALL.nd`.
Pierre Ozoux's avatar
Pierre Ozoux committed
8

Pierre Ozoux's avatar
Pierre Ozoux committed
9
## Modular
Pierre Ozoux's avatar
Pierre Ozoux committed
10

Pierre Ozoux's avatar
Pierre Ozoux committed
11
The PaaS is really modular, that's why it contains the strict necessary, then you'll probably want to add `system` modules or `applications`.
Pierre Ozoux's avatar
Pierre Ozoux committed
12

Pierre Ozoux's avatar
Pierre Ozoux committed
13
## System modules
Pierre Ozoux's avatar
Pierre Ozoux committed
14

Pierre Ozoux's avatar
Pierre Ozoux committed
15
Here is a list of modules supported:
Pierre Ozoux's avatar
Pierre Ozoux committed
16
 - [HAproxy](https://github.com/indiehosters/haproxy)
Pierre Ozoux's avatar
Pierre Ozoux committed
17 18 19 20 21 22 23 24 25 26 27 28 29 30 31
 - 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:
Pierre Ozoux's avatar
Pierre Ozoux committed
32 33

```
Pierre Ozoux's avatar
Pierre Ozoux committed
34
provision -a github.com/indiehosters/wordpress -u example.org -s
Pierre Ozoux's avatar
Pierre Ozoux committed
35 36
```

Pierre Ozoux's avatar
Pierre Ozoux committed
37
Run `provision` for more details on the capabilities of the script.
Pierre Ozoux's avatar
Pierre Ozoux committed
38

Pierre Ozoux's avatar
Pierre Ozoux committed
39
## Contributing
40

Pierre Ozoux's avatar
Pierre Ozoux committed
41
If you have any issue (something not working, mail marked as spam, missing doc), please do report an issue here! Thanks
42

Pierre Ozoux's avatar
Pierre Ozoux committed
43
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!
pierreozoux's avatar
pierreozoux committed
44

Pierre Ozoux's avatar
Pierre Ozoux committed
45 46 47 48 49 50 51
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!