{"id":1381,"date":"2018-11-13T23:21:39","date_gmt":"2018-11-13T20:21:39","guid":{"rendered":"http:\/\/kifarunix.com\/?p=1381"},"modified":"2024-03-11T21:35:51","modified_gmt":"2024-03-11T18:35:51","slug":"how-to-install-and-configure-sentrifugo-hrms-with-nginx-on-ubuntu-18-04","status":"publish","type":"post","link":"https:\/\/kifarunix.com\/how-to-install-and-configure-sentrifugo-hrms-with-nginx-on-ubuntu-18-04\/","title":{"rendered":"How to Install and Configure Sentrifugo HRMS with Nginx on Ubuntu 18.04"},"content":{"rendered":"\n<p>Today, we are going to learn about how to install and setup Sentrifugo HRMS on Ubuntu 18.04. Sentrifugo HRMS is a free and open-source human resource management system (HRMS) software that allows easy management of human resource process in small to mid-sized business across a variety of industries. It offers a number of adaptable features to meet the needs of both managers and employees including;<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>It comes bundled with appraisal modules that enables managers to access the performance of their employees.<\/li>\n\n\n\n<li>Enables employees to access and manage individual information<\/li>\n\n\n\n<li>Helps in making hiring decisions through its comprehensive job candidate background checks.<\/li>\n\n\n\n<li>Provides leave management option for a department or an entire business unit.<\/li>\n<\/ul>\n\n\n\n<p>Sentrifugo has got a handful of features which you can read more about <a href=\"https:\/\/sourceforge.net\/p\/sentrifugo\/wiki\/Home\/\" target=\"_blank\" rel=\"noopener\">here<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Installing Sentrifugo HRMS on Ubuntu 18.04<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Pre-requisite<\/h3>\n\n\n\n<p>As a pre-requisite, Sentrifugo requires a <a href=\"https:\/\/kifarunix.com\/howtos\/how-to-setup-lemp-stack-nginx-mariadb-php-7-2-on-ubuntu-18-04\/\" target=\"_blank\" rel=\"noopener\">LEMP<\/a>\/<a href=\"https:\/\/kifarunix.com\/howtos\/how-to-install-lamp-stack-apachemariadb-php-7-2-on-ubuntu-18-04-lts\/\" target=\"_blank\" rel=\"noopener\">LAMP<\/a> Stack. Therefore, before you can proceed with this guide, ensure that LEMP Stack in installed, at least in this guide since we are going to run Sentrifugo with Nginx web server.<\/p>\n\n\n\n<p>Regarding PHP, ensure that the MySQL PDO as well as the GD libraries are installed. You can verify this as shown&nbsp; below;<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">php7.2 -m | egrep 'pdo_|gd'\ngd\npdo_mysql<\/pre>\n\n\n\n<p>If the modules listed above are not available, install them as shown below;<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">sudo apt install php7.2-{mysql,gd}<\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Create a Database for Sentrifugo HRMS<\/h3>\n\n\n\n<p>Create a database that can be used to store Sentrifugo application data.<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">sudo mysql -u root -p<\/pre>\n\n\n\n<pre class=\"wp-block-preformatted\">create database sentrifugo;<\/pre>\n\n\n\n<p>After that, you need to create a database user account for exclusively management of Sentrifugo. Be sure to grant this user all privileges on the Sentrifugo database;<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">grant all privileges on sentrifugo.* to hradmin@localhost identified by \"<strong>PASSWORD<\/strong>\";<\/pre>\n\n\n\n<p>Flush the database privileges to reload the database grant tables and exit the database;<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">flush privileges;\nquit<\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Download Sentrifugo application<\/h3>\n\n\n\n<p>Once your server has met the above per-requisites, go ahead and download the Sentrifugo application from <a href=\"http:\/\/www.sentrifugo.com\/download\" target=\"_blank\" rel=\"noopener\">Sentrifugo download page<\/a> to your web root directory.<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">sudo wget http:\/\/www.sentrifugo.com\/home\/downloadfile?file_name=Sentrifugo.zip -O \/tmp\/sentrifugo.zip<\/pre>\n\n\n\n<p>After downloading it, unzip it to your web root directory as shown below.<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">unzip \/tmp\/sentrifugo.zip -d \/var\/www\/html\/<\/pre>\n\n\n\n<p>This will extract Sentrifugo application to <strong>Sentrifugo_3.2<\/strong>. Move this directory to <strong>sentrifugo<\/strong> and set the proper permissions for the application.<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">sudo mv \/var\/www\/html\/Sentrifugo_3.2\/ \/var\/www\/html\/sentrifugo<\/pre>\n\n\n\n<pre class=\"wp-block-preformatted\">sudo chown -R www-data.www-data \/var\/www\/html\/sentrifugo\nsudo chmod -R 755 \/var\/www\/html\/sentrifugo<\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Configure Nginx<\/h3>\n\n\n\n<p>After you have installed Sentrifugo and set the proper permissions, create Nginx server block for Sentrifugo application as shown below;<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">sudo vim \/etc\/nginx\/sites-available\/sentrifugo<\/pre>\n\n\n\n<pre class=\"wp-block-preformatted\"># Server block configuration\n#\nserver {\n        listen 80;\n        #\n        # Define the web root directory;\n        root \/var\/www\/html\/sentrifugo;\n        # Add index.php to the list\n        index index.php index.html index.htm;\n        server_name hr.example.com;\n        # Add nginx Rewrite Rules for Sentrifugo\n        location \/ {\n                try_files $uri $uri\/ \/index.php?$args;\n        }\n        # pass PHP scripts to FastCGI server\n        location ~ \\.php$ {\n                include snippets\/fastcgi-php.conf;\n                fastcgi_pass unix:\/var\/run\/php\/php7.2-fpm.sock;\n                fastcgi_param   SCRIPT_FILENAME $document_root$fastcgi_script_name;\n        }\n\n}<\/pre>\n\n\n\n<p>Enable Sentrifugo server block and restart Nginx<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">sudo ln -s \/etc\/nginx\/sites-available\/sentrifugo \/etc\/nginx\/sites-enabled\/<\/pre>\n\n\n\n<p>Before you can restart Nginx, verify that the configuration has no syntax errors;<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">sudo nginx -t\nnginx: the configuration file \/etc\/nginx\/nginx.conf syntax is ok\nnginx: configuration file \/etc\/nginx\/nginx.conf test is successful<\/pre>\n\n\n\n<p>If all is well, go ahead and restart Nginx<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">sudo systemctl restart nginx<\/pre>\n\n\n\n<p>Configure PHP FPM to set the correct timezone. Edit the file <code>\/etc\/php\/7.2\/fpm\/php.ini<\/code> such that your configuration looks like;<\/p>\n\n\n\n<pre class=\"wp-block-preformatted\">[Date]\n; Defines the default timezone used by the date functions\n; http:\/\/php.net\/date.timezone\n;date.timezone =\n<strong>date.timezone = Africa\/Nairobi<\/strong><\/pre>\n\n\n\n<h2 class=\"wp-block-heading\">Configure Sentrifugo HRMS<\/h2>\n\n\n\n<p>Once you are done with the configuration above, it is time to configure Sentrifugo. Most of the next configurations&nbsp; will be done from the web interface. Therefore, navigate to the browser and enter the IP\/hostname address of your server in order to access Sentrifugo.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"http:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-web-setup-wizard.png\"><img loading=\"lazy\" decoding=\"async\" width=\"1031\" height=\"931\" src=\"http:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-web-setup-wizard.png\" alt=\"sentrifugo-web-setup-wizard\" class=\"wp-image-1384\" title=\"\" srcset=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-web-setup-wizard.png 1031w, https:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-web-setup-wizard-768x694.png 768w\" sizes=\"(max-width: 1031px) 100vw, 1031px\" \/><\/a><\/figure>\n\n\n\n<p>Since all the per-requisites are met, click <strong>Next<\/strong> to configure Sentrifugo database. Be sure to enter the database connection details set above.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"http:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-db-configuration.png\"><img loading=\"lazy\" decoding=\"async\" width=\"716\" height=\"596\" src=\"http:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-db-configuration.png\" alt=\"sentrifugo-db-configuration\" class=\"wp-image-1385\" title=\"\"><\/a><\/figure>\n\n\n\n<p>Click <strong>Confirm<\/strong> to proceed and then confirm that you want to proceed.<\/p>\n\n\n\n<p>Next, you need to configure Sentrifugo Applications settings and an email ID for authenticating to Mail Server.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"http:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-app-settings.png\"><img loading=\"lazy\" decoding=\"async\" width=\"727\" height=\"593\" src=\"http:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-app-settings.png\" alt=\"sentrifugo-app-settings\" class=\"wp-image-1386\" title=\"\"><\/a><\/figure>\n\n\n\n<p>Configure Mail Server settings.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"http:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-mail-server-settings.png\"><img loading=\"lazy\" decoding=\"async\" width=\"717\" height=\"608\" src=\"http:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-mail-server-settings.png\" alt=\"sentrifugo-mail-server-settings\" class=\"wp-image-1387\" title=\"\"><\/a><\/figure>\n\n\n\n<p>Configuration final checks.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"http:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/configuration-final-check.png\"><img loading=\"lazy\" decoding=\"async\" width=\"730\" height=\"593\" src=\"http:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/configuration-final-check.png\" alt=\"configuration-final-check\" class=\"wp-image-1388\" title=\"\"><\/a><\/figure>\n\n\n\n<p>Click finish to finalize on the configurations. This will take you to a page where you are given the link to access the application and the login credentials.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"http:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-login-credentials.png\"><img loading=\"lazy\" decoding=\"async\" width=\"804\" height=\"361\" src=\"http:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-login-credentials.png\" alt=\"sentrifugo-login-credentials\" class=\"wp-image-1389\" title=\"\" srcset=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-login-credentials.png 804w, https:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-login-credentials-768x345.png 768w\" sizes=\"(max-width: 804px) 100vw, 804px\" \/><\/a><\/figure>\n\n\n\n<p>The Sentrifugo has been successfully installed. If you login to your email account, you will see an email confirming the successful installation. Now, click on the link to access the Sentrifugo web login user interface.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"http:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-web-login-ui.png\"><img loading=\"lazy\" decoding=\"async\" width=\"1282\" height=\"663\" src=\"http:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-web-login-ui.png\" alt=\"sentrifugo-web-login-ui\" class=\"wp-image-1391\" title=\"\" srcset=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-web-login-ui.png 1282w, https:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-web-login-ui-768x397.png 768w\" sizes=\"(max-width: 1282px) 100vw, 1282px\" \/><\/a><\/figure>\n\n\n\n<p>Login with the credentials shown on the <strong>Finish<\/strong> configuration page. Once you login for the first time, you are welcomed by Sentrifugo default dashboard as shown below;<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"http:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-default-dashboard.png\"><img loading=\"lazy\" decoding=\"async\" width=\"1309\" height=\"901\" src=\"http:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-default-dashboard.png\" alt=\"sentrifugo-default-dashboard\" class=\"wp-image-1392\" title=\"\" srcset=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-default-dashboard.png 1309w, https:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-default-dashboard-768x529.png 768w\" sizes=\"(max-width: 1309px) 100vw, 1309px\" \/><\/a><\/figure>\n\n\n\n<p>The default dashboard introduces you to a configuration wizard where you can enable modules essential to your human resource processes, configure the standards used in your organization, provide your organization information, configure business unit and departments and configure service request settings used in your organization.<\/p>\n\n\n\n<figure class=\"wp-block-image\"><a href=\"http:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-sample-dashboard.png\"><img loading=\"lazy\" decoding=\"async\" width=\"1830\" height=\"855\" src=\"http:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-sample-dashboard.png\" alt=\"sentrifugo-analytics-dashboard\" class=\"wp-image-1393\" title=\"\" srcset=\"https:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-sample-dashboard.png 1830w, https:\/\/kifarunix.com\/wp-content\/uploads\/2018\/11\/sentrifugo-sample-dashboard-768x359.png 768w\" sizes=\"(max-width: 1830px) 100vw, 1830px\" \/><\/a><\/figure>\n\n\n\n<p>Well, feel free to configure this amazing HRMS tool as it best suits you. We hope this was informative. Enjoy your resource management.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Today, we are going to learn about how to install and setup Sentrifugo HRMS on Ubuntu 18.04. Sentrifugo HRMS is a free and open-source human<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"rank_math_lock_modified_date":false,"footnotes":""},"categories":[121,64],"tags":[233,234],"class_list":["post-1381","post","type-post","status-publish","format-standard","hentry","category-howtos","category-ubuntu-18-04","tag-hrms","tag-sentrifugo","generate-columns","tablet-grid-50","mobile-grid-100","grid-parent","grid-50"],"_links":{"self":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/1381"}],"collection":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/comments?post=1381"}],"version-history":[{"count":10,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/1381\/revisions"}],"predecessor-version":[{"id":21064,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/posts\/1381\/revisions\/21064"}],"wp:attachment":[{"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/media?parent=1381"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/categories?post=1381"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kifarunix.com\/wp-json\/wp\/v2\/tags?post=1381"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}