1. Setup Guide

Epesi installation and setup guides for administrators.

Implementation

User Accounts

While creating user account in Epesi, don't set any password. Epesi chooses a random password and sends it via email.


The World's Smallest Open Source ERP Application Server

RasPiEsi Epesi ENS Node v1.0 "Stasiu" Edition

RasPiEsi is The World's Smallest Open Source ERP Application Server powered by Epesi and running on $5 USD Raspberry Pi Zero with 1 CPU and 512 MB RAM DietPi Linux distro and LLMP stack with memcached support and Epesi CRM preinstalled and fully configured.

photo_2023-01-30 04.19.29.jpeg

Ready to run turn-key cloud native application server perfect for microservices because of extremely low memory footprint: only 130 MB of RAM used when idle!

photo_2023-01-30 04.18.58.jpeg

"RasPiEsi is the smallest possible Epesi Node I was able to build with the smallest RAM usage of only 133MB!" wrote Epesi ERP author Janusz Tylek. "Thanks to the excellent DietPi distro this tiny server runs Epesi surprisingly well especially on a fast SD card. It should run unmodified on any Raspberry Pi - from the lowest end $5 RPi Zero with no WiFi and 1 CPU and 512 MB of RAM (used to create this disk image), to the high end RPi 4. Tested fine on RPi 3 - unmodified, just swapped between units!"

raspiesi.png

Janusz Tylek is releasing RasPiEsi to mark the anniversary of his father's birthday. Stanisław Tylek was born on January 30, 1931 in Cracow and lost his father when he was 9 months old. His stepfather did not beat him, thus is how he recalls his childhood. Stanisław (en. Stanley), or "Stasiu" would have been 92 this year, almost as old as David Attenborough. He was an engineer responsible for the Tower of Jasna in Tarnów among other things. A mayor of the Xth district of Cracow elected in the first democratic elections in Poland in 1989. He was an independent and was elected for two 4 year terms.

"I was, I am proud of who my father was and this is an extremely important aspect in a life of every man, every son." said RasPiEsi creator, Janusz Tylek. 

photo_2023-01-30 04.31.08.jpeg

"For my father's Stanisław birthday: January 30th, 1931"

Build cool stuff with it like Epesi RAIN

Epesi RAIN is a cluster of Redundant Array of Inexpensive Nodes build with RasPiEsi nodes.

photo_2023-01-30 19.25.07.jpeg
Image source: https://www.raspberrypi.com/tutorials/cluster-raspberry-pi-tutorial/

Sharing your Epesi projects with Epesi team is greatly appreciated. or open a ticket 

RasPiEsi image

Custom SD image called RasPiEsi (Raspberry Pi Epesi) based on DietPi distro was created by Janusz Tylek on 01/30/2023 for download at SourceForge and Github.

photo_2023-01-30 05.49.03.jpeg

LAMP Stack Variant includes DietPi Linux distro, Lighttpd, MariaDB - tuned config, PHP version 7.4.33 FPM, ZRAM installed, memcached tweaked, mc Midnight Commander, andCustom SD image called.

photo_2023-01-30 04.30.59.jpeg

RasPiEsi's MIT licence allow you to fork it, customize and distribute. 


epesi-github-header-image.png

Epesi ENS = Enterprise Network System is a cloud native Information Technology ecosystem powered by Epesi BIM application running on top of ubiquitous LAMP stack. Epesi is used to build CRM and ERP solutions to store, organize, access and share structured business records. With Epesi you will manage your data precisely, flexibly and easily, simplifying internal communication and making work-flow more efficient. Epesi has been designed as a Kickstarter project and provides "no code" and "low code" environment for PHP developers, IT Managers, startups and DIY tech savvy professionals like you.

Epesi was translated by user community into 40 languages and received SourceForge Open Source Excellence Award.

Celebrate Epesi's 15th Anniversary!
Epesi gave you Free & Open Source CRM. Now you can get Epesi FreeCloud forever to run it.
Epesi free PAAS is designed for Non-profit foundations, Github developers and LinkedIn members including Business owners, StartUps and Epesi Academy Interns. Packages details are available here. 

Epesi. Made with love. 
epesi-logo.png  

Epesi config.php memcached session settings

Attention!

nginx users may experience error 500 when running Epesi for the first time if it was installed using Softaculous.

To fix it edit /data/config/php and add near the botton:

define('EPESI_DIR', '/');
define("MEMCACHE_SESSION_SERVER","127.0.0.1:11211");
define('SESSION_TYPE','memcache');

Technical details

Your /data/config.php file contains a directive where to store sessions. Options are:

Find a section that reads:

define('DIRECTION_RTL','0');
define('EPESI_URL','https://YourEpesiURL');

and find a line that defines how the sessions are handled:

Default: database driver

define('SESSION_TYPE','sql');

or

define("MEMCACHE_SESSION_SERVER","127.0.0.1:11211");
define('SESSION_TYPE','memcache');

or

define('SESSION_TYPE','file');

Memcached sessions are the fastest but you have to make sure Memcached deamon is running and you have PHP memcached extension enabled.

File sessions are the slowest, but easiest to setup.

For EpesiCRM on Windows via Uniserver the following settings are recommended:

// To improve performance
define('SESSION_TYPE','sql');
define("CACHE_COMMON_FILES",1);

If you experience errors in PHP with Epesi Directory, then add the following:

define('EPESI_DIR', '/');

While you are at that check if you have memache installed. Here is a simple script that not only checks for PHP extension, but actually does a test read/write to memcache database deamon:

<?php

$memcache = new Memcache;
 $memcache->connect("localhost",11211); # You might need to set "localhost" to "127.0.0.1"
 echo "Server's version: " . $memcache->getVersion() . "<br />\n";
 $tmp_object = new stdClass;
 $tmp_object->str_attr = "test";
 $tmp_object->int_attr = 123;
 $memcache->set("key",$tmp_object,false,10);
 echo "Store data in the cache (data will expire in 10 seconds)<br />\n";
 echo "Data from the cache:<br />\n";
 var_dump($memcache->get("key"));

?>

Create a file called mctest.php and paste the above to run the test.

If you verify that memcache works - switch to it, this should give you the best performance and you will get fewer session lock errors.

Epesi ERP application server setup guide via Terminal

1. sudo apt-get install  - y mc htop ncdu neofetch apache2 mysql-server php7.4 libapache2-mod-php7.4 php7.4-mysql

2. Open browser and point to IP address of the server, you should see Apache welcome page

3. cd /var/www
Remove index.html, create index.php with context phpinfo() and repeat step 2. 
This time you should see the phpinfo()  page. 

4. Verify needed extensions (ctrl f) 
If the extensions are missing install them and enable them in php.ini 
Path to correct php.ini will be shown in phpinfo() 

5. wget epesi.zip latest version from SourceForge and unzip into /var/www 

6. Using Mysql command line create new database with new user name and new password 

7. Repeat step 2. this time you should get Epesi wizard setup page and follow steps and you will have Epesi running