meta data for this page
  •  

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
installation_hestiacp [2023/09/21 17:48] – johnnyinstallation_hestiacp [2025/01/18 12:25] (current) – reword security note wrongecho
Line 1: Line 1:
 +===== Security =====
 +
 +  * Whilst we are confident in the safety of the code, no system is risk-free. Nearly all software has bugs. Use your best judgement before storing highly confidential information in ITFlow.
 +
 +  * Need to report a security issue? Check the [[https://github.com/itflow-org/itflow/security/policy|security policy]].
 +
 +  * **ITFlow comes with ABSOLUTELY NO WARRANTY, to the extent permitted by applicable law**.
 +
 +----
 +
 A Fantastic Free and Opensource Web Hosting Control Panel [[https://hestiacp.com]] A Fantastic Free and Opensource Web Hosting Control Panel [[https://hestiacp.com]]
 +
  
 ====== Admin Level ====== ====== Admin Level ======
 +
 +===== Install HestiaCP =====
 +  * Install on Debian 12 **without** Mail, DNS and Apache //(Nginx will be used instead)// This will provide the most ultimate performance for ITFlow
  
 ===== Install PHP Mods ===== ===== Install PHP Mods =====
 //These modules are not installed as part of the default HestiaCP Install// //These modules are not installed as part of the default HestiaCP Install//
  
-  * Login as root: ''apt install php-intl php-imap php-mailparse php-curl -y''+  * Login as root:  
 +  * ''apt update'' 
 +  * ''apt install php-intl php-imap php-mailparse php-curl -y''
  
 ===== Create User ===== ===== Create User =====
   - Login to HestiaCP as admin https://host.yourdomain.ext:8083   - Login to HestiaCP as admin https://host.yourdomain.ext:8083
-  - Create Normal user with bash shell access - //it defaults to no login// +  - Create Normal user with bash shell access - //it defaults to no login// {{:hestia-install-8.png?direct&200|}} 
-  - Logout as admin Login as newly created user+  - Logout as admin
  
  
Line 17: Line 33:
  
 ===== Create Web Domain ===== ===== Create Web Domain =====
-  - Click Create Web Domain +  - Login as newly created user 
-  - Enter your FQDN - //for example itflow.mycompany.com//+  - Click Create Web Domain {{:hestia-install-1.png?direct&200|}} 
 +  - Enter your FQDN - //for example itflow.mycompany.com// {{:hestia-install-2.png?direct&200|}}
   - Click Save   - Click Save
   - Edit the newly created Web Domain   - Edit the newly created Web Domain
-  - Click Enable SSL for this domain and the 3 options under it should be checked as well.+  - Click Enable SSL for this domain and the 3 options under it should be checked as well. {{:hestia-install-4.png?direct&200|}}
     - Use Let's Encrypt to obtain SSL certificate     - Use Let's Encrypt to obtain SSL certificate
     - Enable automatic HTTPS redirection     - Enable automatic HTTPS redirection
Line 28: Line 45:
  
 ===== Create Database ===== ===== Create Database =====
-  - Click DB +  - Click DB {{:hestia-install-5.png?direct&200|}} 
-  - Click Add Database+  - Click Add Database {{:hestia-install-6.png?direct&200|}}
   - Name the database   - Name the database
   - create username for database you can use the same name as the database name for simplicity   - create username for database you can use the same name as the database name for simplicity
-  - make a secure password+  - make a secure password {{:hestia-install-7.png?direct&200|}}
   - Click Save   - Click Save
  
Line 38: Line 55:
   - Login with your new user via ssh - ssh username@host.domain.ext   - Login with your new user via ssh - ssh username@host.domain.ext
   - Change to Web root Directory ''cd /home/[USERNAME]/web/[HOST.DOMAIN.EXT]/public_html''   - Change to Web root Directory ''cd /home/[USERNAME]/web/[HOST.DOMAIN.EXT]/public_html''
-  - Delete HestiaCP automatic created files rm * - //This will delete index.html and robots.txt//+  - Delete HestiaCP automatic created files ''rm *'' - //This will delete index.html and robots.txt//
   - Install ITFlow files via git - ''git clone https://github.com/itflow-org/itflow.git .'' - Do not forget the . at the end   - Install ITFlow files via git - ''git clone https://github.com/itflow-org/itflow.git .'' - Do not forget the . at the end
  
 ===== Follow Web Install Process ===== ===== Follow Web Install Process =====
  
 +  * Visit https://yourdomain.com
 ===== Setup Cron Jobs ===== ===== Setup Cron Jobs =====
   - Log back into HestiaCP   - Log back into HestiaCP
   - Click Cron   - Click Cron
-  - Add the Cron Jobs in the documentation [[cron|here]]+  - Add each of the Cron Jobs in the documentation [[cron|here]] 
 +{{:hestia-cron_add.png?direct|}} 
 + 
 +===== Tweaks (Optional) ===== 
 +  * Click Users > Packages > Edit Default Package 
 +    * Set Backups to something other than the default 1 - **7 to 14** is a good practice 
 +    * Set SSH Access from nologin to bash 
 +  * PHP Settings Default to the following - Click gear icon top right > Click on php8.2-fpm 
 +{{:hestia-php_settings.png?direct|}} 
 +  * MariaDB Settings - Click gear icon top right > Click on mariadb 
 +{{:hestia-mariadb_settings.png?direct|}} 
 +  * NginX Settings - Click gear icon top right > Click on nginx 
 +{{:hestia-nginx_settings.png?direct|}} 
  
 +===== Troubleshooting =====
 +  * shell_exec and exec must be enabled in Server Settings > Configure > Web Server > php-fpm
 +  * If mailparse is listed as not installed in ITFlow - Debug and no feedback is returned when running ''php -m | grep mailparse'', you must install mailparse for your version of PHP. E.g., ''apt-get install php8.2-mailparse''