[L]inux [E]ngine-X [M]ariaDB [P]HP Install[ER]

LEMPer stands for Linux, Engine-X (Nginx), MariaDB and PHP installer written in Bash script. This is just a small toolset (a bunch collection of scripts) that usually I use to deploy and manage LEMP stack on Debian/Ubuntu server. LEMPer is crafted to support wide-range PHP framework & CMS. It is available as Free Alternative to control panel such as cPanel, Plesk, CloudWays, Ploi, RunCloud, ServerPilot, etc.

Features

Nginx from Ondrej's repository.
Nginx build from source with Mod PageSpeed module.
Nginx with FastCGI cache enable & disable feature (via LEMPer CLI).
Nginx pre-configured optimization for low-end VPS/cloud server. Need reliable VPS/cloud server? Get one from UpCloud or DigitalOcean.
Nginx virtual host (vhost) configuration optimized for WordPress, and several PHP Frameworks.
Support HTTP/2 natively for your secure website.
Free SSL certificates from Let's Encrypt.
Get an A+ grade on several SSL Security Test (Qualys SSL Labs, ImmuniWeb, and Wormly).
Multiple PHP versions 5.6 [EOL], 7.0 [EOL], 7.1 [EOL], 7.2 [EOL], 7.3 [SFO], 7.4, 8.0 from Ondrej's repository.
Run PHP as user who own the file (Multi-user isolation via FPM pool). Feel the faster Nginx with secure multi-user environment like a top-notch shared hosting.
Supported PHP Framework and CMS:
- Vanilla PHP: default,
- Framework: codeigniter, laravel, lumen, phalcon, symfony,
- CMS: drupal, mautic, roundcube, sendy, wordpress, wordpress-ms (multi-site), and
- more coming soon.
PHP Zend OPcache.
PHP Loader, ionCube & SourceGuardian.
SQL database with MariaDB 10 (MySQL drop-in replacement).
NoSQL database with MongoDB.
In-memory database with Redis.
Memory cache with Memcached.
Adminer web-based SQL & MongoDB database manager (PhpMyAdmin replacement).
phpRedisAdmin web-based Redis database manager.
phpMemcachedAdmin web-based Memcached manager.
TinyFileManager alternative web-based filemanager (Experimental).

Setting Up

Ensure that you have git installed.
Clone LEMPer Git repositroy, git clone https://github.com/joglomedia/LEMPer.git.
Enter LEMPer directory.
Make a copy of .env.dist to .env cp .env.dist .env and replace the values.
Execute install.sh file, sudo ./install.sh.

Install LEMPer Stack

sudo apt-get install git && \
git clone -q https://github.com/joglomedia/LEMPer.git && \
cd LEMPer && \
cp -f .env.dist .env && \
sudo ./install.sh

Remove LEMPer Stack

sudo ./remove.sh

LEMPer Command Line Administration Tool

LEMPer comes with friendly command line tool which will make your LEMP stack administration much easier. These command line tool called Lemper CLI (lemper-cli) for creating new virtual host and managing existing LEMP stack.

LEMPer CLI Usage

Here are some examples of using LEMPer CLI.

LEMPer CLI add new vhost / website

sudo lemper-cli create -u ${USER} -d example.test -f wordpress -w ${HOME}/webapps/example.test --install-skeleton

⚠️ For local/development environment, in order to make the test domain (e.g. example.test) working as expected, you need to do a small workaround by modifying the /etc/hosts file. By adding the local domain name to the hosts file and assign it with local/private IP address.

Since version 2.4.0 this workaround could be done via lemper-cli by passing --ipv4 parameter and assign it with private IP address, as below:

sudo lemper-cli create -u ${USER} -d example.test -f wordpress \ 
-w ${HOME}/webapps/example.test --ipv4=127.0.10.1 --install-skeleton

For more info

sudo lemper-cli create --help

LEMPer CLI manage vhost / website

Example, enable SSL

sudo lemper-cli manage --enable-ssl example.test

Example, enable FastCGI cache

sudo lemper-cli manage --enable-fastcgi-cache example.test

For more info

sudo lemper-cli manage --help

for more help

sudo lemper-cli help

Note: Lemper CLI will automagically add a new PHP-FPM user's pool configuration if it doesn't exists. You must add the user account first.

Web-based Administration

You can access pre-installed web-based administration tools here

http://YOUR_IP_ADDRESS:8082/lcp/

Adminer (Web-based SQL database managemer)

http://YOUR_DOMAIN_NAME:8082/lcp/dbadmin

TinyFileManager (Web-based file managemer)

http://YOUR_DOMAIN_NAME:8082/lcp/filemanager

TODOs

Custom build latest Nginx from source
Add Let's Encrypt SSL
Add network security (iptable rules, firewall configurator, else?)
Add database backup tool (Mariabackup, Percona Xtrabackup, else?)
Add enhanced security (AppArmor, cgroups, jailkit (chrooted/jail users), fail2ban, else?)
Add file backup tool (Borg, Duplicati, Rclone, Restic, Rsnapshot, else?)
Add server monitoring (Amplify, Monit, Nagios, else?)
Add user account & hosting package management

Add your feature request here

Security Vulnerabilities and Bugs

If you discover any security vulnerability or any bug within LEMPer Stack, please open an issue.

Contributing

Fork it (https://github.com/joglomedia/LEMPer/fork)
Create your feature branch (git checkout -b my-new-feature) or fix issue (git checkout -b fix-some-issue)
Commit your changes (git commit -am 'Add some feature') or (git commit -am 'Fix some issue')
Push to the branch (git push origin my-new-feature) or (git push origin fix-some-issue)
Create a new Pull Request
GitHub Workflows will be run to make sure that your changes does not have errors or warning

Awesome People

LEMPer Stack is an open-source project licensed under the GNU GPLv3 license with its ongoing development made possible entirely by the support of all these smart and generous people, from code contributors to financial contributors. 💜

Thank you for considering contributing to this project!

Project Maintainers

Edi Septriyanto
@joglomedia

Code Contributors

Made with contributors-img.

Financial Contributors

You can support us using any of the methods below:

Buy Me a Bottle of Milk or a Cup of Coffee !!

Licence

LEMPer stack is open-source project licensed under the GNU GPLv3 license.

numbnet / lemper Goto Github PK

lemper's Introduction