Installation

• Minimum system requirements
• Command-line Installation steps
• Post-installation steps
  • Setting up the scheduler

Before you proceed, you should check that your server meets the minimum system requirements.

Minimum system requirements

timegrid has some server requirements for web hosting:

1. PHP >= 5.5.9
2. OpenSSL PHP Extension
3. PDO PHP Extension
4. Mbstring PHP Extension
5. Tokenizer PHP Extension
6. Nginx or Apache web server
7. MySQL server

Advice: PHP 7 is not yet supported.

As of PHP 5.5, some OS distributions may require you to manually install the PHP JSON extension. When using Ubuntu, this can be done via apt-get install php5-json.

Command-line installation

• Step 1: Get the code
• Step 2: Use Composer to install dependencies
• Step 3: Create Database
• Step 4: Install
• Step 5: Start Page
• Optional: Populate DB with a Demo Sandbox Data Fixture

Step 1: Get the code

git clone https://github.com/alariva/timegrid.git

cd timegrid

---

Step 2: Install dependencies with Composer

composer install

---

Step 3: Create the Database

Once you finished the first three steps, you can create the MySQL database server. You must create the database with utf-8 collation (utf8_general_ci), for the application to work.

---

Step 4: Configure the Environment

Copy the .env.example file to .env

cp .env.example .env

Edit the .env file and set the database configuration among the other settings.

Set the application key

php artisan key:generate

Edit all the Primary section parameters (for local/test/development environment)

Change the storage path in .env file to a writeable location

STORAGE_PATH=/home/username/timegrid/storage

For local environment you will need to comment out APP_DOMAIN, to keep it null

#APP_DOMAIN=

Back to your console, migrate database schema

php artisan migrate

Populate the database:

php artisan db:seed

Update geoip database:

php artisan geoip:update

And we are ready to go. Run the server:

php artisan serve

Type on web browser:

http://localhost:8000/

---

Step 5: Start Page

Congrats! You can now register as new user and log-in.

Demo Sandbox Fixture

If you want to try the application with a Lorem Ipsum database fixture.

php artisan db:seed --class=TestingDatabaseSeeder

Now you have two demo credentials to log in and play around.

USER: demo@timegrid.io
PASS: demomanager

USER: guest@example.org
PASS: demoguest

Post-installation steps

There are some things you may need to set up after the installation is complete.

Setting up the scheduler

For scheduled tasks to operate correctly, you should add the following Cron entry to your server. Editing the crontab is commonly performed with the command crontab -e.

* * * * * php /path/to/artisan schedule:run >> /dev/null 2>&1

Be sure to replace /path/to/artisan with the absolute path to the artisan file in the root directory of timegrid. This Cron will call the command scheduler every minute.

Note: If you are adding this to /etc/cron.d you'll need to specify a user immediately after * * * * *.