Adding nginx alternative config file and updating INSTALL.md for nginx usage
parent
7ec7032581
commit
5c48de7779
|
@ -1,8 +1,9 @@
|
||||||
## Requirements
|
## Requirements
|
||||||
|
|
||||||
An Ubuntu server (18.04/20.04 should both work fine) - though other linux installations should work too.
|
An Ubuntu server (18.04/20.04 should both work fine) - though other linux installations should work too.
|
||||||
- apache2, mysql/mariadb, sqlite need to be installed and running
|
- apache2 (or nginx), mysql/mariadb, sqlite need to be installed and running
|
||||||
- php extensions for intl, mysql, sqlite3, mbstring, xml need to be installed and running
|
- php extensions for intl, mysql, sqlite3, mbstring, xml need to be installed and running
|
||||||
|
- php extention for curl (not required but makes composer run a little faster)
|
||||||
- composer
|
- composer
|
||||||
|
|
||||||
## Network requirements
|
## Network requirements
|
||||||
|
@ -17,8 +18,16 @@ Cerebrate communicates via HTTPS so in order to be able to connect to other cere
|
||||||
## Cerebrate installation instructions
|
## Cerebrate installation instructions
|
||||||
|
|
||||||
It should be sufficient to issue the following command to install the dependencies:
|
It should be sufficient to issue the following command to install the dependencies:
|
||||||
|
|
||||||
|
- for apache
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sudo apt install apache2 mariadb-server git composer php-intl php-mbstring php-dom php-xml unzip php-ldap php-sqlite3 sqlite libapache2-mod-php php-mysql
|
sudo apt install apache2 mariadb-server git composer php-intl php-mbstring php-dom php-xml unzip php-ldap php-sqlite3 php-curl sqlite libapache2-mod-php php-mysql
|
||||||
|
```
|
||||||
|
|
||||||
|
- for nginx
|
||||||
|
```bash
|
||||||
|
sudo apt install nginx mariadb-server git composer php-intl php-mbstring php-dom php-xml unzip php-ldap php-sqlite3 sqlite php-fpm php-curl php-mysql
|
||||||
```
|
```
|
||||||
|
|
||||||
Clone this repository (for example into /var/www/cerebrate)
|
Clone this repository (for example into /var/www/cerebrate)
|
||||||
|
@ -73,7 +82,7 @@ sudo -u www-data cp -a /var/www/cerebrate/config/config.example.json /var/www/ce
|
||||||
sudo -u www-data vim /var/www/cerebrate/config/app_local.php
|
sudo -u www-data vim /var/www/cerebrate/config/app_local.php
|
||||||
```
|
```
|
||||||
|
|
||||||
mod_rewrite needs to be enabled:
|
mod_rewrite needs to be enabled if __using apache__:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sudo a2enmod rewrite
|
sudo a2enmod rewrite
|
||||||
|
@ -106,16 +115,31 @@ sudo rm /var/www/cerebrate/tmp/cache/persistent/*
|
||||||
|
|
||||||
Create an apache config file for cerebrate / ssh key and point the document root to /var/www/cerebrate/webroot and you're good to go
|
Create an apache config file for cerebrate / ssh key and point the document root to /var/www/cerebrate/webroot and you're good to go
|
||||||
|
|
||||||
For development installs the following can be done:
|
For development installs the following can be done for either apache or nginx:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
|
# Apache
|
||||||
# This configuration is purely meant for local installations for development / testing
|
# This configuration is purely meant for local installations for development / testing
|
||||||
# Using HTTP on an unhardened apache is by no means meant to be used in any production environment
|
# Using HTTP on an unhardened apache is by no means meant to be used in any production environment
|
||||||
sudo cp /var/www/cerebrate/INSTALL/cerebrate_dev.conf /etc/apache2/sites-available/
|
sudo cp /var/www/cerebrate/INSTALL/cerebrate_apache_dev.conf /etc/apache2/sites-available/
|
||||||
sudo ln -s /etc/apache2/sites-available/cerebrate_dev.conf /etc/apache2/sites-enabled/
|
sudo ln -s /etc/apache2/sites-available/cerebrate_apache_dev.conf /etc/apache2/sites-enabled/
|
||||||
sudo service apache2 restart
|
sudo service apache2 restart
|
||||||
```
|
```
|
||||||
|
|
||||||
|
OR
|
||||||
|
|
||||||
|
```bash
|
||||||
|
# NGINX
|
||||||
|
# This configuration is purely meant for local installations for development / testing
|
||||||
|
# Using HTTP on an unhardened apache is by no means meant to be used in any production environment
|
||||||
|
sudo cp /var/www/cerebrate/INSTALL/cerebrate_nginx.conf /etc/nginx/sites-available/
|
||||||
|
sudo ln -s /etc/nginx/sites-available/cerebrate_nginx.conf /etc/nginx/sites-enabled/
|
||||||
|
sudo systemctl disable apache2 # may be required if apache is using port
|
||||||
|
sudo service nginx restart
|
||||||
|
sudo systemctl enable nginx
|
||||||
|
|
||||||
|
```
|
||||||
|
|
||||||
Now you can point your browser to: http://localhost:8000
|
Now you can point your browser to: http://localhost:8000
|
||||||
|
|
||||||
To log in use the default credentials below:
|
To log in use the default credentials below:
|
||||||
|
|
Loading…
Reference in New Issue