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_apt [2023/08/12 03:20] – add commands for php file upload limits wrongechoinstallation_apt [2024/02/10 07:06] (current) – wrongecho
Line 12: Line 12:
  
 ===== Install Overview ===== ===== Install Overview =====
-ITFlow runs on most "standard" Linux web servers. For the core functionality, you just need Apache, a database (MariaDB is highly recommended over MySQL) and PHP.+ITFlow runs on most "standard" Linux web servers. For the core functionality, you just need Apache, a database (MariaDB is highly recommended over MySQL) and PHP. 
  
   - Install a LAMP stack (Linux, Apache, MariaDB & PHP)   - Install a LAMP stack (Linux, Apache, MariaDB & PHP)
Line 23: Line 23:
  
 ===== Ubuntu Setup Guide ===== ===== Ubuntu Setup Guide =====
 +
 +//This guide assumes you want to install ITFlow to the default ''/var/www/html/'' directory, adjust this as required if you're using vhosts.//
 +
 **Update apt** **Update apt**
  
Line 56: Line 59:
 **Adjust PHP File Upload Limits** **Adjust PHP File Upload Limits**
  
-  * ''sudo nano  /etc/php/php.ini'' - Adjust: +  * ''sudo nano  /etc/php/{PHP VERSION}/apache2/php.ini'' - Adjust: 
-    * ''upload_max_filesize = 20M'' +    * ''upload_max_filesize = 500M'' 
-    * ''post_max_size = 20M''+    * ''post_max_size = 500M''
  
 **Enable SSL** **Enable SSL**
Line 112: Line 115:
   * ''git clone https://github.com/itflow-org/itflow.git .''   * ''git clone https://github.com/itflow-org/itflow.git .''
      
-**Set the web folder to be owned by Apache**+**Set the web folder to be owned by Apache's www-data user**
   * ''sudo chown -R www-data:www-data /var/www/html''   * ''sudo chown -R www-data:www-data /var/www/html''
  
-**Set web folder permissions** //(all, for now, we'll change this after setup)//+**Set web folder & git permissions**
   * ''sudo chmod -R 777 /var/www/html''   * ''sudo chmod -R 777 /var/www/html''
 +  * ''sudo git config --system --add safe.directory '*'''
  
 **Run through the initial setup by navigating to your web server using HTTPS** **Run through the initial setup by navigating to your web server using HTTPS**
   * Provide the database name, username, and password you set up earlier when prompted   * Provide the database name, username, and password you set up earlier when prompted
      
-**Once complete, tidy up the webserver permissions** +**Once complete, tidy up the webserver permissions** //(The Apache/www-data user needs access to edit files as it self-updates using Git)// 
-  * ''sudo find /var/www/html -type d -exec chmod 775 {} \;'' +  * ''sudo chmod -R 775 /var/www/html''
-  * ''sudo find /var/www/html -type f -exec chmod 664 {} \;''+
   * ''sudo chmod 640 /var/www/html/config.php''   * ''sudo chmod 640 /var/www/html/config.php''
      
-==== Essential Housekeeping ==== 
- 
-  * [[backups|Backups]]: Especially your master encryption key 
-  * [[config_php|Config.php]]: Check you don't need to add any specific variables (e.g. not using HTTPS) 
-  * [[cron|Cron]]: For scheduled activities 
-  * [[email_config|Email Configuration]]: To send outbound emails (invoicing, tickets, etc) 
-  * [[ticket_email_parse|Email to Ticket]]: To receive inbound ticketing emails 
  
 **Done!** **Done!**
 +
 +
 +----
 +
 +
 +==== ITFlow on Windows is unsupported ====
 +
 +Whilst it is //technically possible// to install ITFlow on Windows, we do not recommend this and cannot offer support for it. Many PHP functions simply do not work properly on Windows.