# Installation

> This page is a straightforward how to install bitaac, more in depth tutorials using nginx etc are still work 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

### Install bitaac using composer

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

Once the install have completed, navigate into the fresh application folder:
```php
cd bitaac
```

> Sometimes composer fails to copy .env.example to .env, so if you dont find the .env file just manually copy the .env.example 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
```