Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Catch up with upstream #1

Open
wants to merge 31 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
31 commits
Select commit Hold shift + click to select a range
9d90aec
Create a basic roadmap
pierreozoux Feb 14, 2017
b871840
Add service catalog to ROADMAP
pierreozoux Mar 28, 2017
e59501d
typo
JOduMonT Mar 28, 2017
212f1b9
Merge pull request #145 from jodumont/patch-1
pierreozoux Mar 28, 2017
dd7006d
add libre stats
JOduMonT Mar 28, 2017
5185830
Merge pull request #147 from jodumont/patch-3
pierreozoux Mar 29, 2017
e76505c
Add Fosdem installation video
pierreozoux Apr 6, 2017
b0440dd
Stricter sshd config
pierreozoux Apr 11, 2017
b34211c
Add the www
pierreozoux Jun 30, 2017
13b022b
Add Linux instructions
JOduMonT Jul 3, 2017
d835ffc
Remove trailing space
pierreozoux Jul 3, 2017
ae35435
Fix codestyle
pierreozoux Jul 3, 2017
a3eb487
Fix typo + sshkey (#151)
JOduMonT Aug 14, 2017
b0df1b0
vm.overcommit_memory & transparent_hugepage (#154)
JOduMonT Aug 21, 2017
63e81f7
disable transparent hugepage (#153)
JOduMonT Aug 21, 2017
b6853ee
add vm.overcommit_memory=1 (#152)
JOduMonT Aug 21, 2017
1128a89
Fix typo in user_data (#155)
JOduMonT Aug 30, 2017
3766449
unable to write transparent_hugepage (#157)
JOduMonT Sep 18, 2017
1210767
specify sysctl file (#163)
lalop Feb 24, 2018
edc5e96
Added backers and sponsors on the README (#168)
monkeywithacupcake Feb 28, 2018
b41c8f3
fix contributors link
lalop Mar 3, 2018
dce1ce8
I add zerotier as network solution (#172)
JOduMonT Jun 6, 2018
7556c39
Update ROADMAP.md
freechelmi Sep 29, 2018
5d24dce
add headers for CRSF check
Jan 7, 2019
39f4a5c
add headers for CRSF check
Jan 7, 2019
1ac7f2c
Adds more kubernetes stuff.
pierreozoux Jan 28, 2019
931d8d7
New libre.sh chat
freechelmi Jan 28, 2019
983718b
Fix indentation
pierreozoux Feb 15, 2019
fab6a85
Removes repo that are deprecated.
pierreozoux Feb 20, 2019
cfd8fdd
archive project
unteem Feb 20, 2019
e327bbf
Delete .gitignore
Feb 20, 2019
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion .gitignore

This file was deleted.

61 changes: 0 additions & 61 deletions CHANGELOG.md

This file was deleted.

36 changes: 0 additions & 36 deletions INSTALL.md

This file was deleted.

75 changes: 0 additions & 75 deletions INSTALL_HETZNER.md

This file was deleted.

103 changes: 1 addition & 102 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,102 +1 @@
# libre.sh

## Introduction

A PaaS that is aimed at hosting free software \o/

To install it, follow instructions in `INSTALL.md`.

### What is libre.sh

libre.sh is a little framework to host Docker. It is simple and modular and respect the convention over configuration paradigm.

This is aimed at Hosters to manage a huge amount of different web application, and a quantity of domain names related with emails and so on.

It is currently installed at 3 different hosters in production and hosting ~20 different web applications, with ~500 containers.

Once well installed, in one bash command, you'll be able to:
- buy a domain name
- configure DNS for it
- configure email for it
- configure dkim for that domain
- configure dmarc for that domain
- configure autoconfig for that domain
- install and start a web application on that domain (WordPress, Nextcloud, piwik...)
- provision a TLS cert on that domain

Amazing, right?

### Modular

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

It contains 2 [unit-files](https://github.com/indiehosters/LibrePaaS/tree/master/unit-files) to manage system modules and applications, start them at boot, and load the appropriate environment.

### Support

You can use the following channels to request community support:
- [mailinglist/forum](https://forum.indie.host/t/about-the-libre-sh-category/71)
- [chat](https://chat.indie.host/channel/libre.sh)

For paid support, just send an inquiry to [email protected].

All of this is hosted by libre.sh :)

## System modules

Here is a list of modules supported:
- https proxy:
- [HAProxy](https://github.com/indiehosters/haproxy)
- [Nginx](https://github.com/indiehosters/nginx)
- [logs](https://github.com/indiehosters/logs)
- [monitoring](https://github.com/indiehosters/monitoring)
- [git-puller](https://github.com/indiehosters/git-puller)
- [backups](https://github.com/indiehosters/backups)
- [sshd](https://github.com/indiehosters/sshd)

Go to their respective page for more details.

### To install and start a module:

```
cd /system/
git clone module
cd module
libre enable
libre start
```

## Applications

### Installation

To install application `wordpress` on `example.org`, first make point example.org to your server IP, and then, just run:

```
libre provision -a github.com/indiehosters/wordpress -u example.org -s
```

Run `libre provision` for more details on the capabilities of the script.

## To debug a module or an application:

```
libre ps
libre logs -f --tail=100
libre stop
libre restart
```

## Contributing

If you have any issue (something not working, missing doc), please do report an issue here! Thanks

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!
Moved to https://lab.libreho.st/libre.sh/compose.libre.sh
23 changes: 0 additions & 23 deletions unit-files/[email protected]

This file was deleted.

23 changes: 0 additions & 23 deletions unit-files/[email protected]

This file was deleted.

11 changes: 0 additions & 11 deletions unit-files/web-net.service

This file was deleted.

Loading