libre.sh/compose-website
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
538 commits 1 branch 10 tags 39 MiB
Find a file
JOduMonT 63e81f7d72 disable transparent hugepage (#153) 
as recommanded by REDIS
\# WARNING you have Transparent Huge Pages (THP) support enabled in your kernel. This will create latency and memory usage issues with Redis. To fix this issue run the command 'echo never > /sys/kernel/mm/transparent_hugepage/enabled' as root, and add it to your /etc/rc.local in order to retain the setting after a reboot. Redis must be restarted after THP is disabled.
2017-08-21 16:36:19 +01:00
unit-files Add the www 2017-06-30 11:52:08 +01:00
utils add libre stats 2017-03-29 01:40:38 +02: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.md better installation steps 2016-11-26 16:31:06 +00:00
INSTALL_HETZNER.md typo 2017-03-28 12:50:47 +02:00
INSTALL_LINUX.md vm.overcommit_memory & transparent_hugepage (#154) 2017-08-21 16:36:13 +01:00
LICENSE Initial commit 2014-09-24 14:40:03 +01:00
README.md Add Fosdem installation video 2017-04-06 20:31:37 +01:00
ROADMAP.md Add service catalog to ROADMAP 2017-03-28 09:45:06 +01:00
user_data disable transparent hugepage (#153) 2017-08-21 16:36:19 +01:00

README.md

libre.sh

Introduction

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

Installation

ScreenShot

To install it, follow the video above and 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 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.

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

  • 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!