No description

Find a file

freechelmi 6eee160235 Merge branch 'release/1.1'		2020-02-26 18:51:57 +01:00
unit-files	Add the www	2017-06-30 11:52:08 +01:00
utils	Disabling dynamic email creation for now	2019-12-26 00:29:12 +01:00
.gitignore	Install instructions \o/	2016-02-11 11:30:19 +00:00
CHANGELOG.md	Updates changelog	2015-01-29 11:13:11 +00:00
INSTALL.cloud.md	Rename install.md into install.cloud.md	2019-12-26 18:00:53 +01:00
install.linux.sh	Select version branch when cloning libre.sh	2020-02-26 16:29:08 +01:00
INSTALL_HETZNER.md	typo	2017-03-28 12:50:47 +02:00
INSTALL_LINUX.md	Merge branch 'master' into develop	2020-02-26 18:45:26 +01:00
LICENSE	Initial commit	2014-09-24 14:40:03 +01:00
README.md	Release 1.1	2020-02-26 18:49:26 +01:00
ROADMAP.md	Update ROADMAP.md	2018-10-02 08:45:48 +02:00
user_data	unable to write transparent_hugepage (#157 )	2017-09-18 20:48:10 +02:00

README.md

libre.sh Version 1.1

Introduction

An ecosystem to ease free software hosting \o/

We are working on bootstrapping an ecosystem of tools to facilitate the hosting of free software. Think of it as

ISPconfig
FLOSS cpanel
cloudron with email

Libre.sh V1 (Stable) is using docker-compose
Libre.sh V2 (Alpha) is using kubernetes.

This ecosystem can be deployed on Raspberries or on popular cloud providers and scale globally or anything in between. We can affirm that V2 scales globally because it is based on kubernetes, a tool developped from the experience of Google hosting containers at scale.

Installation

To install it, follow the instructions in INSTALL_LINUX.md : https://lab.libreho.st/libre.sh/compose.libre.sh/blob/master/INSTALL_LINUX.md

Or run our installer script

https://lab.libreho.st/libre.sh/compose.libre.sh/raw/master/install.linux.sh

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 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:

For paid support, just send an inquiry to support@libre.sh.

You can also watch the Fosdem Video : Video Fosdem

All of this is hosted by libre.sh :)

System modules

Here is a list of modules supported:

Go to their respective page for more details.

To install and start a module:

cd /system/
git clone https://lab.libreho.st/libre.sh/compose/[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 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: