Skip to content

Setup Guide

Jump to bottom
Amit Srivastava edited this page Apr 18, 2018 · 3 revisions

OctoberERP Setup Guide :

Author: Amit Srivastava ([email protected])

This program includes a step by step guide to setup PHP (Laravel) environment (Linux Ubuntu 16.04).

  • This article is a step by step tutorial to get started with PHP and laravel in Linux environment ( Ubuntu ). By installing Apache2, Mysql and PHP, your LAMP server is ready to host your PHP application.

  • These packages will be required to install OctoberERP,

    • Ubuntu 16.04
    • Php > 7.0
    • Apache2
    • Mysql 5.7
    • Git

Installation Steps

  1. Clone application in your web folder lets say it will be /home/www, needs to create virtual host is appache to access application
cd /home/www
git clone -b master https://github.com/lokios/octobererp.git
  1. Import database

Import seed table into your database by executing these commands,

mysql -u your-username -p your-database < /home/www/octobererp/docs/octobererp_db.sql

Backend adminstrator credentails Username : admin Password : test

  1. Setup application configuration files

  • These files need to be update as per your local settings

    • cms.php
    • database.php
    • filesystems.php
    • mail.php
    • services.php

  • Update cms.php, if you confirgure filesystem storage other than local

  • Update configuration files for database setup

nano /home/www/octobererp/config/database.php

Update your database settings at : 'mysql' => [ 'driver' => 'mysql', 'host' => 'localhost', 'port' => 3306, 'database' => 'your-database', 'username' => 'your-username', 'password' => 'your-password', 'charset' => 'utf8', 'collation' => 'utf8_unicode_ci', 'prefix' => '', ],

  • Update fileseystems.php, for your storage settings and their credentials, supported: "local", "s3", "rackspace"

  • Update mail.php & services.php, for mail server setup and their credentials, supported: "smtp", "mail", "sendmail", "mailgun", "mandrill", "log"

  1. Now access your application with url setup in virtual host.

Deployment Script on server

REPO_URL="https://github.com/lokios/octobererp.git"
DEPLOY_BASE_DIR=/home/www
cd $DEPLOY_BASE_DIR
rm -rf DEPLOY_BASE_DIR/octobererp
cd DEPLOY_BASE_DIR
git clone -b master  $REPO_URL

rm -rf $DEPLOY_BASE_DIR/octobererp/storage/framework/sessions/
rm -rf $DEPLOY_BASE_DIR/octobererp/storage/framework/logs/
rm -rf $DEPLOY_BASE_DIR/octobererp/storage/framework/cache/
rm -rf $DEPLOY_BASE_DIR/octobererp/storage/oims/cache/
rm -rf $DEPLOY_BASE_DIR/octobererp/storage/oims/twig/

mkdir -p $DEPLOY_BASE_DIR/octobererp/storage/framework/sessions/
mkdir -p $DEPLOY_BASE_DIR/octobererp/storage/framework/logs/
mkdir -p $DEPLOY_BASE_DIR/octobererp/storage/framework/cache/
mkdir -p $DEPLOY_BASE_DIR/octobererp/storage/oims/cache/
mkdir -p $DEPLOY_BASE_DIR/octobererp/storage/oims/twig/
mkdir -p $DEPLOY_BASE_DIR/octobererp/storage/oims/combiner/
mkdir -p $DEPLOY_BASE_DIR/octobererp/storage/logs/

rm -rf $DEPLOY_BASE_DIR/octobererp/storage/cms/cache/
rm -rf $DEPLOY_BASE_DIR/octobererp/storage/cms/twig/

mkdir -p $DEPLOY_BASE_DIR/octobererp/storage/cms/cache/
mkdir -p $DEPLOY_BASE_DIR/octobererp/storage/cms/twig/
mkdir -p $DEPLOY_BASE_DIR/octobererp/storage/cms/combiner/

cp -Rf /home/deploy/octobererp/prod/config/ $DEPLOY_BASE_DIR/octobererp/


chown -R www-data:www-data $DEPLOY_BASE_DIR/octobererp
find  $DEPLOY_BASE_DIR/octobererp/ -type d -exec chmod 755 {} \;
find  $DEPLOY_BASE_DIR/octobererp/ -type f -exec chmod 644 {} \;
sudo chmod -R 775 $DEPLOY_BASE_DIR/octobererp

Copyright © 2018 opaclabs.com

Clone this wiki locally