Setup

To get Mobilot running locally on your machine, do the following:

Requirements

Node and NPM

macOS We recommend using nvm for managing your node versions.

The following guide might help: http://mfg.fhstp.ac.at/development/webdevelopment/nvm/

Bower

https://bower.io/

Mobilot is using Angular and many useful dependencies, which are mainly installed as bower modules.

We recommend you install bower as a global node module.

npm install bower -g

Gulp CLI

Gulp CLI "Getting Started" guide

If you have previously installed a version of gulp globally, please run npm rm --global gulp to make sure your old version doesn't collide with gulp-cli.

We recommend instaling gulp-cli as a global node module.

npm install gulp-cli -g

Composer

https://getcomposer.org/

Mobilot uses Composer for installing required server dependencies. To install Composer on your machine, follow guide of the official site:

https://getcomposer.org/doc/00-intro.md

NOTE: We recommend installing composer globally.

Server Requirements

Check the minimal requirements for Laravel 4.2 on the official site:

• PHP >= 5.4
• MCrypt PHP Extension

You will also require Python for some building scripts.

• Python 2.7 – https://www.python.org/downloads/

Create database

Manually create a database named mobilot.

NOTE: Currently tested with MySQL databases only.

Install dependencies

Start setup

macOS: sh setup.sh (use sudo if necessary) Windows: setup.bat (run as administrator)

This setup will guide you through the process of installing Mobilot on your machine:

• Asks whether the database has already been created (Y/n), if yes:
• Attempts to create cache, logs, meta, sessions, views directories in app/storage/
• Attempts to create public/upload directory
• Executes composer install
• Asks what kind of environment you are using (H̲omestead/M̲AMP/X̲AMPP):
  • Homestead: Copies setup/database.php to app/config/local/database.php
  • MAMP/XAMPP: Copies setup/database.php to app/config/database.php
• IMPORTANT: Manually configure app/config/database.php before continuing. Check out the Database config section for extra information on some edge cases. Press ENTER when you are done.
• Executes php artisan migrate (requires confirmation)
• Installs npm modules
• Installs bower modules
  • When asked, always choose the later module versions required by Mobilot.
• Creates development-ready build.
• Asks whether you like to serve Mobilot out now (Y/n), if yes:
• Executes php artisan serve

Permissions

IMPORTANT: You might need to manually change the owner of app/storage:

macOS

Use sudo if necessary

chown -R $USER app/storage/

Database config

Laravel requires to specify the unix_socket for some local environments such as MAMP:

'unix_socket' => '/Applications/MAMP/tmp/mysql/mysql.sock'