- \n
- A server running Ubuntu 18.04.<\/li>\n
- A non-root user with sudo privileges.<\/li>\n<\/ul>\n
Getting Started<\/h2>\n
First, update your system with the latest version by running the following command:<\/p>\n
sudo apt-get update -yOnce your system is updated, restart your system to apply the changes.<\/p>\n
Install LAMP Server<\/h2>\n
Before starting, you will need to install Apache, MariaDB, PHP and other PHP modules to your system. You can install all of them by running the following command:<\/p>\n
sudo apt-get install apache2 mariadb-server php7.2 php7.2-bcmath php7.2-cgi php7.2-cli php7.2-common php-curl php7.2-dba php7.2-enchant php7.2-fpm php7.2-gd php7.2-imap php7.2-intl php7.2-ldap php7.2-mbstring php7.2-mysql php7.2-opcache php-imagick php-memcache php7.2-soap php7.2-tidy php7.2-xml php7.2-zip libapache2-mod-php7.2 xvfb libfontconfig wkhtmltopdf unzip wget -y<\/code><\/pre>\nOnce all the packages are installed, you will need to make some changes in php.ini file:<\/p>\n
sudo nano \/etc\/php\/7.2\/apache2\/php.ini<\/code><\/pre>\npost_max_size = 200M \nupload_max_filesize = 200M \nmax_execution_time = 300 \nmemory_limit = 512M \nmax_input_vars = 5000 \n<\/pre>\n
Save and close the file. Then, start Apache and MariaDB service and enable them to start on boot time with the following command:<\/p>\n
sudo systemctl start apache2Configure Database<\/h2>\n
By default, MariaDB is not secure. So, you will need to secure it first. You can secure it by running the following command:<\/p>\n
sudo mysql_secure_installation<\/code><\/pre>\nAnswer all the questions as shown below:<\/p>\n
Enter current password for root (enter for none): Set root password? [Y\/n]: N Remove anonymous users? [Y\/n]: Y Disallow root login remotely? [Y\/n]: Y Remove test database and access to it? [Y\/n]: Y Reload privilege tables now? [Y\/n]: Y \n<\/pre>\n
Once the MariaDB is secured, log in to MariaDB shell:<\/p>\n
mysql -u root -p<\/code><\/pre>\nEnter your root password, then create a database and user for Orangscrum:<\/p>\n
MariaDB [(none)]> CREATE DATABASE orangescrumdb;Replace ‘password’ with a secure password in the abive SQL command.<\/p>\n
Next, flush the privileges and exit from the MariaDB shell:<\/p>\n
MariaDB [(none)]> FLUSH PRIVILEGES;Next, you will need to disable strict mode for MariaDB. You can do this by creating disable_strict_mode.cnf file:<\/p>\n
sudo nano \/etc\/mysql\/conf.d\/disable_strict_mode.cnf<\/code><\/pre>\nAdd the following lines:<\/p>\n
[mysqld] \nsql_mode=\"IGNORE_SPACE,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION\" \n<\/pre>\n
Save and close the file. Then, restart MariaDB to apply all the changes:<\/p>\n
sudo systemctl restart mariadb<\/code><\/pre>\nInstall Orangescrum<\/h2>\n
First, download the latest version of Orangescrum from https:\/\/www.orangescrum.org\/free-download<\/a>.<\/p>\n
cd \/tmpOnce the download is completed, extract the downloaded file with the following command:<\/p>\n
unzip orangescrum-ubuntu18-php7.zip<\/code><\/pre>\nNext, copy the extracted directory to the Apache web root directory:<\/p>\n
sudo cp -r orangescrum-orangescrum-ubuntu18-php7 \/var\/www\/html\/orangescrum-master<\/code><\/pre>\nNext, change the directory to the \/var\/www\/<\/em>html\/<\/em>orangescrum-master<\/em> and import OrangeScrum database into your newly created database:<\/p>\n
cd \/var\/www\/html\/orangescrum-masterEnter the password that you have chosen for the ‘orangescrumuser’ MySQL user when requested by the mysql command.<\/p>\n
Next, edit the database.php file:<\/p>\n
sudo nano app\/Config\/database.php<\/code><\/pre>\nMake the following changes:<\/p>\n
class DATABASE_CONFIG { \n public $default = array( 'datasource' => 'Database\/Mysql', 'persistent' => false, 'host' => 'localhost', 'login' => 'orangescrumuser', 'password' => 'password', 'database' => 'orangescrumdb', 'prefix' => '', 'encoding' => 'utf8', ); \n} \n<\/pre>\nReplace the password with the password that you’ve chosen when creating the database and MySQL user. Save and close the file. Then, edit config.ini.php file:<\/p>\n
sudo nano app\/Config\/config.ini.php<\/code><\/pre>\nAdd your SMTP server details as per your need:<\/p>\n
[EMAIL INFO] \nSMTP_UNAME = admin \nSMTP_PWORD = password \nSMTP_HOST = smtp.example.com \nSMTP_PORT = 25 \n \n[PDF PATH] \nPDF_LIB_PATH = \/usr\/bin\/wkhtmltopdf \n<\/pre>\n
Save and close the file.<\/p>\n
Next, give proper permissions to the orangescrum directory:<\/p>\n
sudo chown -R www-data:www-data \/var\/www\/html\/orangescrum-master\/Configure Apache for Orangescrum<\/h2>\n
Next, create an Apache virtual host file for Orangescrum. You can do this with the following command:<\/p>\n
sudo nano \/etc\/apache2\/sites-available\/orangescrum.conf<\/code><\/pre>\nAdd the following lines:<\/p>\n
<VirtualHost *:80> ServerAdmin [email\u00a0protected]<\/a> DocumentRoot \/var\/www\/html\/orangescrum-master\/ ServerName example.com <Directory \/var\/www\/html\/orangescrum-master\/> DirectoryIndex index.php index.html AllowOverride All Allow from all Order allow,deny Options Indexes FollowSymlinks <\/Directory> \n<\/VirtualHost> \n<\/pre>\n
Replace example.com with your own domain name in the vhost file. Save and close the file.<\/p>\n
Then, enable Apache virtual host file with the following command:<\/p>\n
sudo a2ensite orangescrum.conf<\/code><\/pre>\nNext, enable mbstring, rewrite and headers module with the following command:<\/p>\n
sudo phpenmod mbstringFinally, restart Apache service to apply all the changes by running the following command:<\/p>\n
sudo systemctl restart apache2<\/code><\/pre>\nAccess Orangescrum Web Interface<\/h2>\n
Now, open your web browser and type the URL http:\/\/example.com. You will be redirected to the Orangescrum welcome page:<\/p>\n
![\"Sign](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/11\/how-to-install-and-configure-orangescrum-on-ubuntu-18-04-lts.png\" "\\"\\"")
<\/a><\/p>\nThe error about write permissions in tmp folder can be ignored, the permissions are fine. The error will go away after initial signup.<\/p>\n
Provide your site name, email address and password. Then, click on the Signup<\/strong> button. You will be redirected to the Orangescrum dashboard in the following page:<\/p>\n
![\"OrangeScrum](\"https:\/\/afaghhosting.net\/blog\/wp-content\/uploads\/2018\/11\/how-to-install-and-configure-orangescrum-on-ubuntu-18-04-lts-1.png\" "\\"\\"")
<\/a><\/p>\n