Legacy (PHP/Apache) Application Support (Optional)
Unlike apps such as RaspberryPints and BrewPi-www which use Apache to serve webpages, Fermentrack uses nginx. If you wish to run applications other than Fermentrack on the same Raspberry Pi you will need to configure nginx to serve those applications instead of Apache.
Fermentrack-tools includes a script which can be used to install this support automatically.
Understanding Legacy Support
To support legacy applications, the fermentrack-tools script does the following:
php5-fpmto allow Nginx to serve php files
apache2from launching at startup
- Create a new nginx configuration file serving webpages from
/var/www/htmlon port 81
Note - Due to the port change mentioned above, any apps that were previously running at
http://<your-ip>/ will now be running at
Although fermentrack-tools offers a script to allow for fully automated installation of support for PHP/legacy apps, support can be installed manually as well.
To run the fully automated installation script, simply SSH into your Raspberry Pi and execute:
curl -L install-legacy-support.fermentrack.com | sudo bash
To manually install legacy app support, you will need to do the following as root:
- Install PHP5 support -
apt-get install php5-common php5-cli php5-fpm
apache2from running at startup -
update-rc.d apache2 disable
- Disable any currently running instance of
service apache2 stop
- Install the appropriate configuration file to
nginx. An example configuration file can be found here, and must be installed in
- Restart PHP5-FPM -
service php5-fpm restart
- Restart Nginx -
service nginx restart
Legacy BrewPi-www Installation Support
Although performing the above actions will allow brewpi-www to run alongside Fermentrack, doing so is not recommended. Attempting to run brewpi-www in this way can result in issues as Fermentrack and brewpi-www compete to access/manage your fermentation controller.