# Installation

> This page is a straight forward "How to install bitaac" guide. A more indepth guide is still in progress.

### Prerequisites

* [Composer](https://getcomposer.org/)
* Database with a TFS 1.0+ schema imported.
* [Laravel server requirements](https://laravel.com/docs/5.6#installation):
  * PHP >= 7.1.3
  * OpenSSL PHP Extension
  * PDO PHP Extension
  * Mbstring PHP Extension
  * Tokenizer PHP Extension
  * XML PHP Extension
  * Ctype PHP Extension
  * JSON PHP Extension

### Installing bitaac using composer

First, install bitaac using composer:
```php
composer create-project bitaac/bitaac --prefer-dist
```

Once bitaac is installed, navigate to the bitaac application folder:
```php
cd bitaac
```

> Sometimes composer fails to copy the ".env" file, If this happens simply rename the existing ".env.exmaple" file to ".env"

Now you will have to set your database credentials inside the .env file:
```env
DB_DATABASE=homestead
DB_USERNAME=homestead
DB_PASSWORD=secret
```


### Publish assets & configs

```php
php artisan vendor:publish --tag=bitaac:assets &&
php artisan vendor:publish --tag=bitaac:admin:assets &&
php artisan vendor:publish --tag=bitaac:config
```

### Database migrations & seeds

```php
php artisan migrate --seed
```

### Encryption key

Composer should set the encryption key automatically, but sometimes it fails to do so. If you experience the "No application encryption key has been specified." error you can generate & set a new encryption key:

```php
php artisan key:generate
```